chore: restructure nested 6a2ml files into .machine_readable/6a2/

Author: hyperpolymath

verisimdb/schema/clade.vql

@@ -0,0 +1,47 @@
+-- SPDX-License-Identifier: PMPL-1.0-or-later
+-- VQL schema: Clade definition octad
+
+DEFINE SCHEMA clade VERSION 1.0.0;
+
+DEFINE GRAPH clade {
+  members: [UUID],              -- repos in this clade (primary membership)
+  secondary_members: [UUID],    -- repos with secondary membership
+  related_clades: [{            -- inter-clade relationships
+    clade: STRING(2),
+    relationship: ENUM("depends_on", "feeds_into", "shares_infra", "overlaps")
+  }]
+};
+
+DEFINE TENSOR clade {
+  member_count: INT,
+  avg_completion: FLOAT,
+  active_count: INT,
+  stale_count: INT
+} TEMPORAL;
+
+DEFINE SEMANTIC clade {
+  type: ENUM("clade"),
+  code: STRING(2),
+  name: STRING,
+  description: TEXT,
+  colour: STRING,
+  icon: STRING,
+  keywords: [STRING]
+};
+
+DEFINE DOCUMENT clade {
+  title: STRING,
+  description: TEXT,
+  health_report: TEXT?          -- generated health summary
+} INDEXED;
+
+DEFINE TEMPORAL clade {
+  created: TIMESTAMP,
+  last_member_change: TIMESTAMP,
+  last_health_check: TIMESTAMP?
+};
+
+DEFINE PROVENANCE clade {
+  creator: STRING,
+  last_modifier: STRING
+};

verisimdb/schema/repo.vql

@@ -0,0 +1,99 @@
+-- SPDX-License-Identifier: PMPL-1.0-or-later
+-- VQL schema: Repository octad
+-- Each repository is an 8-modality entity in VeriSimDB
+
+DEFINE SCHEMA repo VERSION 1.0.0;
+
+-- Graph modality: relationships between repos
+DEFINE GRAPH repo {
+  depends_on: [UUID],           -- repos this depends on
+  depended_by: [UUID],          -- repos depending on this
+  clade_edge: UUID,             -- link to clade octad
+  monorepo_parent: UUID?,       -- parent monorepo (if child)
+  monorepo_children: [UUID],    -- children (if monorepo)
+  forge_links: {                -- primary + foreign key links
+    github: STRING,
+    gitlab: STRING?,
+    bitbucket: STRING?,
+    codeberg: STRING?,
+    sourcehut: STRING?,
+    radicle: STRING?
+  },
+  tags: [STRING]                -- free-form tags
+};
+
+-- Vector modality: semantic embedding for similarity search
+DEFINE VECTOR repo {
+  purpose_embedding: FLOAT[384],  -- sentence-transformer embedding of description
+  tech_embedding: FLOAT[384]      -- embedding of technology stack
+};
+
+-- Tensor modality: numeric metrics over time
+DEFINE TENSOR repo {
+  completion: FLOAT,            -- 0.0 to 100.0
+  loc: INT,                     -- lines of code
+  test_count: INT,              -- number of tests
+  open_issues: INT,             -- open issue count
+  dependency_count: INT         -- direct dependencies
+} TEMPORAL;                     -- time-series tracking enabled
+
+-- Semantic modality: typed metadata
+DEFINE SEMANTIC repo {
+  type: ENUM("repo"),
+  clade_primary: STRING(2),     -- 2-char clade code
+  clade_secondary: [STRING(2)],
+  license: STRING,              -- SPDX identifier
+  languages: [STRING],          -- programming languages used
+  version: STRING?,             -- current version if applicable
+  status: ENUM("active", "stale", "archived", "experimental", "complete"),
+  lineage_type: ENUM("standalone", "monorepo", "monorepo-child", "inflated", "deflated")
+};
+
+-- Document modality: full-text searchable content
+DEFINE DOCUMENT repo {
+  title: STRING,                -- display name
+  description: TEXT,            -- one-line description
+  readme_summary: TEXT?,        -- first section of README
+  setup_instructions: TEXT?,    -- extracted setup/install docs
+  changelog_latest: TEXT?,      -- latest changelog entry
+  state_body: TEXT?             -- STATE.a2ml content cache
+} INDEXED;                      -- full-text search enabled
+
+-- Temporal modality: time tracking
+DEFINE TEMPORAL repo {
+  created: TIMESTAMP,           -- repo creation date
+  last_commit: TIMESTAMP?,      -- most recent git commit
+  last_state_change: TIMESTAMP?,-- last meaningful state update
+  last_activity: TIMESTAMP,     -- max(commit, state_change, bot_finding)
+  sessions: [{                  -- work sessions
+    id: STRING,
+    started: TIMESTAMP,
+    ended: TIMESTAMP?,
+    agent: STRING               -- "claude-code", "jonathan", etc.
+  }]
+};
+
+-- Provenance modality: origin and authority tracking
+DEFINE PROVENANCE repo {
+  creator: STRING,              -- who created the repo
+  last_modifier: STRING,        -- who last changed state
+  authority_pointers: [{        -- pointer authority system
+    field: STRING,              -- which field
+    type: ENUM("pointer", "local", "derived"),
+    source: STRING?,            -- external source path (if pointer)
+    hash: STRING?,              -- SHA-256 of cached value
+    synced_at: TIMESTAMP?
+  }],
+  attestations: [{              -- signed attestations
+    claim: STRING,
+    signer: STRING,
+    signature: STRING,
+    timestamp: TIMESTAMP
+  }]
+};
+
+-- Spatial modality: reserved for future use
+DEFINE SPATIAL repo {
+  org_x: FLOAT?,               -- position in org hierarchy visualisation
+  org_y: FLOAT?
+};

verisimdb/schema/todo.vql

@@ -0,0 +1,56 @@
+-- SPDX-License-Identifier: PMPL-1.0-or-later
+-- VQL schema: Work item / TODO octad
+-- Replaces scattered memory files, queue dumps, and bot logs
+
+DEFINE SCHEMA todo VERSION 1.0.0;
+
+DEFINE GRAPH todo {
+  repo: UUID?,                  -- associated repo (if any)
+  clade: STRING(2)?,            -- associated clade (if any)
+  blocks: [UUID],               -- TODOs this blocks
+  blocked_by: [UUID],           -- TODOs blocking this
+  resulted_from: UUID?,         -- feedback/observation that spawned this
+  resulted_in: UUID?            -- commit/PR that resolved this
+};
+
+DEFINE TENSOR todo {
+  priority: INT,                -- 0 = P0 (highest), 7 = P7 (lowest)
+  effort_estimate: INT?,        -- estimated hours (optional)
+  progress: FLOAT               -- 0.0 to 1.0
+} TEMPORAL;
+
+DEFINE SEMANTIC todo {
+  type: ENUM("todo"),
+  category: ENUM("bug", "feature", "refactor", "docs", "security", "infra", "governance", "research"),
+  status: ENUM("open", "in_progress", "blocked", "done", "wontfix", "superseded"),
+  source: ENUM("human", "bot", "agent", "ci")
+};
+
+DEFINE DOCUMENT todo {
+  title: STRING,
+  body: TEXT,
+  resolution: TEXT?             -- how it was resolved (if done)
+} INDEXED;
+
+DEFINE TEMPORAL todo {
+  created: TIMESTAMP,
+  updated: TIMESTAMP,
+  due: TIMESTAMP?,
+  started: TIMESTAMP?,
+  completed: TIMESTAMP?,
+  acknowledged: TIMESTAMP?      -- when someone first saw this
+};
+
+DEFINE PROVENANCE todo {
+  creator: STRING,              -- who/what created it
+  creator_type: ENUM("human", "bot", "agent"),
+  assignee: STRING?,
+  session_id: STRING?,          -- which session created it
+  authority_pointers: [{
+    field: STRING,
+    type: ENUM("pointer", "local", "derived"),
+    source: STRING?,
+    hash: STRING?,
+    synced_at: TIMESTAMP?
+  }]
+};