Single Concept Format Specification v0.94
This repository publishes the CLF 0.94 pre-standard draft — the file format for a single concept in the COLIBRI Concept Library.
Concept Purity Rule
A concept file expresses only what a concept IS and what is perceptually typical of it. It contains no detection logic, no rules, no algorithms, no thresholds, and no references to other concepts. All interpretation belongs exclusively to the control layer.
A concept file MUST NOT contain any structure, field, reference, or wording that can be interpreted as prescribing, constraining, guiding, or implying any behavior of the control layer, inference layer, or any system that consumes the concept.
Format Status
This specification is published at version 0.94. The format is intentionally not yet final.
The goal of the COLIBRI Concept Library is broad adoption across industries and systems. A format that is to become a shared standard must be shaped by those who will use it.
Status of This Document
This document specifies the CLF 0.94 pre-standard draft — the file format for a single concept in the COLIBRI Concept Library. CLF is one component of a broader standard currently under development, which will also cover registration practices, concept identifier naming, versioning at the library level, and governance.
This is not the final standard. The final specification will be decided together with early adopters, implementers, and domain experts.
No rights to implement, deploy, or integrate this format are granted. All commercial and technical usage requires a separate license from the rights holder.
Underlying invention protected by Finnish Utility Model No. 13913.
Contents
| File | Description |
|---|---|
clf_concept_spec_v0.94.md |
Single concept format specification v0.94 |
Concept_library_wp.pdf |
White paper — full theoretical foundation |
What_is_Concept_Library.md |
Introductory guide — what the Concept Library is and why it exists |
clf_control_layer_v1.py |
Control layer reference implementation — loads CLF concepts, matches queries, produces audit trail |
demo.py |
Runnable demo — five example queries with full semantic audit trail output |
DEMO.md |
Usage guide for the control layer reference implementation |
C-003.partial_discharge/ |
Example concept — partial discharge (electrical insulation phenomenon) |
C-005.cat/ |
Reference concept — domestic cat (Felis catus) |
Reference Concept
C-005.cat is a fully realized reference implementation of the CLF 0.94 format,
covering all seven perceptual modalities with genuine data:
| Modality | Content |
|---|---|
| Linguistic | English canonical definition, exclusions, semantic scope |
| Visual | Parametric SVG silhouette (Bezier ears, vertical-slit pupils, whiskers, tail arc) |
| Acoustic | Synthetic FLAC prototype — FM sweep 500→900→450 Hz with 4 harmonics, ADSR envelope |
| Signal | Real MFCC-13, spectral centroid (1392 Hz), rolloff (2738 Hz), computed from prototype |
| Haptic | Fur texture, temperature, body density, motion resistance |
| Chemical | Olfactory profile — 2-acetyl-1-pyrroline, pheromone classes |
| Electromagnetic | Coat static triboelectric, infrared thermal profile |
The concept also includes integrity data: a full SHA-256 hash tree over all payload files and a Merkle root as the container hash.
Format History
| Version | Date | Change |
|---|---|---|
| 0.9 | 2026-04-30 | Initial pre-standard draft |
| 0.92 | 2026-05-05 | Added SVG and WAV to allowed formats; concept_kind moved exclusively to taxonomy.json; definition_language required in manifest; i18n translations removed (belong to control layer); English mandated as canonical language |
| 0.93 | 2026-05-06 | biological/cognitive removed from concept_kind (domains, not kinds); prototype_spectral_features moved to acoustic.json; section numbering fixed; container structure shows prototype file paths |
| 0.94 | 2026-05-06 | constraints.json removed entirely — classification conditions belong to control layer; labels restricted to English only; control layer boundary table extended |
Control Layer Reference Implementation
The control layer is the component that decides what a given input IS — and explains why. A concept file describes what something is. The control layer does the matching.
clf_control_layer_v1.py is a reference implementation of the control layer included in this repository.
It loads any CLF concept folder, accepts multi-modal queries (text, acoustic features, signal data),
and returns the best-matching concept together with a full semantic audit trail.
python demo.py
See DEMO.md for full usage instructions and code examples.
Production use, commercial deployment, and integration into third-party systems requires a separate license from the rights holder.
White Paper
Concept Library by Pekka Lepola, 2026.
The white paper presents the theoretical foundation, architectural consequences, EU AI Act implications, and a proof-of-concept semantic decision trace.
© 2026 Pekka Lepola. All rights reserved.
The concept library and control layer invention is protected by Finnish Utility Model No. 13913.
No part of this specification may be used, reproduced, or implemented without explicit written permission from the rights holder.
Licensing & Pilot Program: Organizations interested in piloting the COLIBRI Concept Library may acquire a paid pilot license. Contact: conceptlibrary.eu@gmail.com