dedalo

The Dédalo v7 TypeScript/Bun rewrite of the SECTION family (src/core/section/) and the vanilla-JS CLIENT RENDERING CONTRACT that the section structure-context must satisfy or the client silently crashes. Use when working in v7/master_dedalo on section reads/edits, structure-context (resolve/structure_context.ts), the section module (section/context.ts, buttons.ts, read.ts, record/, list_definitions/), virtual sections, the section_list/list-mode css, groupers, buttons, section_map, or when the copied client renders a blank/broken edit or list view. Covers the exact context fields the client requires (type='grouper', features, target_sections, css swap), how each missing field crashes which client file, virtual-section resolution, and the Chrome-MCP debugging + stale-server-restart workflow.

Master orientation for the Dédalo v7 TypeScript/Bun rewrite — READ THIS FIRST before any src/ work. Covers what v7 TS is (a from-scratch Bun/TS rewrite of the PHP monolith, which is a READ-ONLY oracle on the SAME Postgres), the codebase's load-bearing law ("tripwire or delete"), the 11 tripwires and what each guards, the subsystem/dependency map, the post-WS-C home rule (dispatch.ts = registry+gates+envelope only → api/handlers/<class>.ts; read routing in section/read_facade.ts), where the audit lives, and the map to every sibling skill. Use when starting any src/ TS work, asking "where does X live", "how is the TS server structured", architecture/layering/boundary questions, "is there an invariant about…", checking a flagged path before touching it, or onboarding. Live state: rewrite/LEDGER.md. Spec: engineering/REWRITE_SPEC.md.

Configuration discipline and running the Dédalo v7 TS/Bun server in production. Use when reading or adding a DEDALO_* config key, touching process.env / src/config/env.ts (readEnv) / src/config/config.ts / ../private/.env, wiring a COEXISTENCE flag (DEDALO_DIFFUSION_NATIVE, DEDALO_DEV_MODE, DEDALO_SESSION_DB_PATH), or doing anything ops: deploy/systemd, the unix socket + reverse proxy (SERVER_UNIX_SOCKET), graceful shutdown (SIGTERM drain), boot migrations, backups, /health, /api/v1/counters observability, or pool sizing (DB_POOL_MAX). Also for "config key isn't taking effect", config_env_tripwire or coex_tag_tripwire failures, and "how do we run this in production". Authoritative ops doc: engineering/PRODUCTION.md; validation checklist: engineering/STAGING_VALIDATION.md; PHP↔TS shared-DB rules: rewrite/COEXISTENCE.md; config precedence + key census: dedalo-config skill + ../private/sample.env.

The Dédalo v7 TypeScript/Bun rewrite of the ONTOLOGY definition & provisioning pipeline — the dd_ontology write layer, the parse_section_record_to_ontology_node parser, the incremental/destructive write drivers (setRecords/regenerate), hierarchy provisioning (generate_virtual_section), and the tool_ontology/tool_ontology_parser/tool_hierarchy handlers. Use when editing src/core/db/dd_ontology.ts, src/core/ontology/{parser,ontology_write}.ts, src/core/resolve/hierarchy_provision.ts, tools/tool_{ontology,ontology_parser,hierarchy}/server/*.ts, or debugging why a parsed dd_ontology row, a provisioned thesaurus, or a runtime ontology read diverges from the PHP oracle. Shared foundation with dedalo-tree-ts. PHP oracle: v7_php_frozen/master_dedalo/core/ontology/class.ontology.php, core/hierarchy/class.hierarchy.php, core/db/class.dd_ontology_db_manager.php, tools/tool_{ontology,ontology_parser,hierarchy}.

The reusable workflow for the Dédalo PHP→TypeScript/Bun rewrite where the live PHP server is the ORACLE — differential parity gates, in-process probe scripts diffing TS vs PHP, driving the real PHP client via Chrome DevTools MCP to find client-contract bugs, scratch-twin write hygiene (never mutate real records), and the dev-server/env setup. Use when verifying a TS port matches PHP, when a component renders wrong in the browser, when writing a *_differential.test.ts gate, or when a bug is reported against the running client (e.g. "X is not resolved in client").

The Dédalo v7 TypeScript/Bun rewrite of the RELATION component family — the strangler-fig subsystem in src/core/relations/ (registry dispatch, relation_core shared engine, per-model resolvers, implicit/explicit request_config builders, dataframe id_key pairing, inverse/children/related/index engines, save hooks). Use when editing src/core/relations/**, src/core/section/read.ts relation emission (the shared emitDdoData — read_rows.ts is DELETED), src/core/search/conform.ts relation dispatch, or debugging why a portal/autocomplete/dataframe/children/index/related component resolves wrong vs the PHP oracle. Authoritative spec: engineering/RELATIONS_SPEC.md (§1 addendum: phases A-E LANDED); ledger: rewrite/STATUS.md "Relations rebuild".

The Dédalo v7 TypeScript/Bun rewrite of the thesaurus/ontology TREE — the ts_object node builder, dd_ts_api (get_node_data/get_children_data/add_child/update_parent_data/save_order), tree search, the component_relation_parent machinery, and the shared transaction/advisory-lock primitives that every tree/ontology mutation is built on. Use when editing src/core/ts_object/**, src/core/relations/parent.ts, the dd_ts_api registration in src/core/api/dispatch.ts, the area_thesaurus/area_ontology serving in src/core/area/ (tree.ts boot payload + read.ts dispatch), or debugging why a tree node/child/expand/move/reorder resolves wrong vs the PHP oracle. Shared foundation with dedalo-ontology-ts. PHP oracle: v7_php_frozen/master_dedalo/core/ts_object, core/api/v1/common/class.dd_ts_api.php, core/area_thesaurus.

Web-server-enforced media file access control in the Dédalo v7 TS/Bun engine — the .publication marker store, the fixed-name daily auth cookie, the filename→record grammar, and the GENERATED Apache/nginx rule files. Use when editing src/core/media/protection.ts, the login media-cookie hook (core/security/auth.ts + server.ts Set-Cookie assembly), the media_control maintenance widget, src/diffusion/targets/mediastore/media_index.ts, or when debugging why media 404s for a logged-in user, why anonymous users can (or cannot) read published media, or a media_protection_tripwire failure.

How to EXTEND the Dédalo v7 TypeScript/Bun engine the descriptor-shaped way — add a component model, a tool, or an area without scattering edits. Use when adding or editing a component model (src/core/components/component_<model>/descriptor.ts + registry.ts), when descriptor_completeness_tripwire.test.ts or import_scc_tripwire.test.ts FAILS, when asking "why do I have to edit N files to add a model", when wiring emitHook / searchBuilder / resolveData / flatValue / importValueProperty facets, when adding a new cross-subsystem lookup and hitting a static-import cycle (SCC of size >1), or when adding a tool (src/core/tools/) or an area. Names: ComponentModel, getComponentModel, registerComponentModelFieldsLookup, RESOLVER_IMPLEMENTATIONS, EMIT_HOOKS, usesImportValueProperty. Checklist lives in src/core/components/README.md; state in rewrite/LEDGER.md.

Request isolation and caching without cross-request bleed or stale-after-edit serving in the Dédalo v7 TypeScript/Bun rewrite. ONE Bun process serves concurrent requests via 3 AsyncLocalStorage stores — transaction ALS (src/core/db/postgres.ts withTransaction), request-lang ALS (src/core/resolve/request_lang.ts runWithRequestLangs / currentApplicationLang / currentDataLang), request-context ALS (src/core/security/request_context.ts currentPrincipal). Use when adding or editing ANY module-level cache/singleton (new Map/Set/let), any createOntologyCache / createDataCache (src/core/ontology/cache_factory.ts), any ALS read (currentPrincipal / currentApplicationLang / currentDataLang / withTransaction), background-job/scheduler identity threading, or when debugging "cross-request bleed", "wrong language shown to user", "wrong actor in audit rows", "stale after edit", or a module_state_tripwire.test.ts failure. Authoritative: engineering/REQUEST_ISOLATION.md; state: rewrite/LEDGER.md.