manifest etc

Author: denisecase

.pre-commit-config.yaml

@@ -93,7 +93,7 @@ repos:
   # === REPO: RUFF PRE-COMMIT (for Python code) ===
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.15.10
+    rev: v0.15.12
     hooks:
       - id: ruff-check
         name: D1) Ruff linter with autofix (runs first in pre-commit)

CHANGELOG.md

@@ -1,5 +1,7 @@
 # Changelog
 
+<!-- markdownlint-disable MD024 -->
+
 All notable changes to this project will be documented in this file.
 
 The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/)**

README.md

@@ -45,12 +45,10 @@
 
 ### In a machine terminal
 
-After you get a copy of this repo in your own GitHub account,
-open a machine terminal in `Repos` or where you want the project:
+Open a machine terminal where you want the project:
 
 ```shell
-# Replace username with YOUR GitHub username.
-git clone https://github.com/username/se-kernel
+git clone https://github.com/structural-explainability/se-kernel
 
 cd se-kernel
 code .

SE_MANIFEST.toml

@@ -4,11 +4,11 @@
 
 schema = "se-manifest-2"
 
-# === Identity ===
+# === Repository Identity ===
 
 [meta]
 # WHY: Minimal metadata; versioned separately via Git tags
-name = "se-kernel"
+name = { repo = "se-kernel", kind = "semantic", version = "main" }
 org = "structural-explainability"
 status = "active"
 version = "0.1.0"
@@ -18,12 +18,14 @@ version = "0.1.0"
 class = "kernel"
 summary = "Invariant primitives and structural constants for the SE ecosystem."
 
-# === Structural contract ===
+# === Dependency Declarations ===
 
 [depends]
 optional = []
 required = []
 
+# === Provided Artifacts ===
+
 [provides]
 # WHY: Explicit artifact ownership (core to this repository)
 artifacts = [
@@ -33,6 +35,8 @@ artifacts = [
   "constants",
 ]
 
+# === Scope ===
+
 [scope]
 # WHY: Keep this tight and structural
 includes = [

pyproject.toml

@@ -32,7 +32,7 @@ dev = [
 
 docs = [
     # REQ.DOCS.DEPS: External packages used to generate project documentation.
-    "zensical",
+    "zensical==0.0.37", # WHY: Link resolution fails with newer versions; pinning to a known working version.,
 ]
 
 # ============================================================
@@ -52,7 +52,10 @@ reportMissingTypeStubs = "none" # WHY: Avoid warnings from third-party libraries
 reportMissingImports = "warning" # WHY: Warn about missing imports to catch potential issues, but allow flexibility in notebooks and dynamic code.
 reportPrivateUsage = "none" # WHY: Allow usage of private members (e.g., _version.py) without warnings, as this is common in Python projects.
 typeCheckingMode = "strict" # strict | basic | off
-useLibraryCodeForTypes = false # WHY: Avoid type checking third-party library code to reduce noise and improve performance.
+
+[[tool.pyright.executionEnvironments]]
+root = "tests"
+typeCheckingMode = "basic" # strict | basic | off
 
 # === PYTEST (VERIFY LOGIC) ===