eidos-ai 0.1.0__tar.gz

eidos_ai-0.1.0/.devcontainer/devcontainer.json

@@ -0,0 +1,59 @@
+{
+  "name": "Eidos Devcontainer",
+  "image": "ubuntu:26.04",
+  "features": {
+    "ghcr.io/devcontainers/features/common-utils:2": {
+      "installZsh": true,
+      "configureZshAsDefaultShell": true,
+      "installOhMyZsh": true,
+      "installOhMyZshConfig": true,
+      "upgradePackages": true,
+      "nonFreePackages": true,
+      "username": "vscode"
+    },
+    "ghcr.io/devcontainers/features/git:1": {},
+    "ghcr.io/devcontainers/features/git-lfs:1": {},
+    "ghcr.io/devcontainers/features/github-cli:1": {},
+    "ghcr.io/devcontainer-community/devcontainer-features/astral.sh-uv:1": {
+      "shellautocompletion": true
+    },
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "moby": false
+    }
+  },
+  "containerEnv": {
+    // uv cannot use hardlinks across the /tmp → workspace boundary in Codespaces;
+    // copy mode avoids "Invalid cross-device link" errors.
+    "UV_LINK_MODE": "copy"
+  },
+  "mounts": [
+    "source=eidos-gemini,target=/home/vscode/.gemini,type=volume"
+  ],
+  "remoteUser": "vscode",
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        // --- Python & Astral Toolchain ---
+        "ms-python.python",
+        "ms-python.debugpy",
+        "ms-python.vscode-python-envs",
+        "charliermarsh.ruff",
+        "astral-sh.ty",
+        // --- Containers & Virtualization ---
+        "ms-azuretools.vscode-containers",
+        // --- Living Architecture & Specifications ---
+        "asciidoctor.asciidoctor-vscode",
+        "mathematic.vscode-pdf",
+        // --- Configuration & Schemas ---
+        "tamasfe.even-better-toml",
+        "redhat.vscode-yaml",
+        // --- Git & Source Control ---
+        "mhutchie.git-graph",
+        "donjayamanne.githistory",
+        // --- AI Agents & Harness ---
+        "google.google-antigravity"
+      ]
+    }
+  }
+}

eidos_ai-0.1.0/.devcontainer/post-create.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+echo "========================================================"
+echo "🚀 Initializing Eidos Dev Container Environment..."
+echo "========================================================"
+
+export PATH="$HOME/.local/bin:$PATH"
+
+# 1. Install Python 3.15 via uv
+echo "==> Ensuring Python 3.15 via uv..."
+uv python install --default 3.15
+
+# 2. Set up Python virtual environment and install Eidos in editable mode
+echo "==> Setting up Eidos virtual environment with Python 3.15..."
+uv venv --python 3.15 .venv
+uv pip install -e ".[dev]"
+
+# 3. Configure persistent AI tool directories and migrate initial backups
+echo "==> Configuring persistent volumes (~/.gemini)..."
+sudo mkdir -p "${HOME}/.gemini"
+sudo chown -R vscode:vscode "${HOME}/.gemini"
+chmod 700 "${HOME}/.gemini"
+
+BACKUP_DIR="${PWD}/backups"
+if [ -d "${BACKUP_DIR}/.gemini" ]; then
+  echo "    Migrating initial Gemini data from ${BACKUP_DIR}/.gemini..."
+  cp -a "${BACKUP_DIR}/.gemini/." "${HOME}/.gemini/"
+  rm -rf "${BACKUP_DIR}/.gemini"
+elif [ -d "${BACKUP_DIR}/gemini" ]; then
+  echo "    Migrating initial Gemini data from ${BACKUP_DIR}/gemini..."
+  cp -a "${BACKUP_DIR}/gemini/." "${HOME}/.gemini/"
+  rm -rf "${BACKUP_DIR}/gemini"
+fi
+
+if [ -d "${BACKUP_DIR}" ]; then
+  rmdir "${BACKUP_DIR}" 2>/dev/null || true
+fi
+
+sudo chown -R vscode:vscode "${HOME}/.gemini"
+
+# 4. Validate Eidos specifications
+if [ -f ".venv/bin/eidos" ]; then
+  echo "==> Validating Eidos living specifications..."
+  .venv/bin/eidos validate eidos || true
+fi
+
+echo "========================================================"
+echo "✅ Eidos Dev Container Ready!"
+echo "   - uv:         $(uv --version)"
+echo "   - python:     $(python --version 2>/dev/null || echo 'not on PATH')"
+echo "========================================================"

eidos_ai-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,90 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  validate:
+    name: Validate Specs & Plugin
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.0
+        with:
+          enable-cache: true
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Validate Eidos living specifications
+        run: uv run eidos validate eidos
+
+      - name: Validate Agent Plugin conformance
+        run: uv run eidos plugin validate
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.0
+        with:
+          enable-cache: true
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --python ${{ matrix.python-version }} --all-extras --dev
+
+      - name: Run test suite with coverage
+        run: uv run pytest -v --cov=src/eidos --cov-report=term-missing
+
+  build-portal:
+    name: Build Living Portal
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.0
+        with:
+          enable-cache: true
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Generate static living portal
+        run: uv run eidos build-site --path eidos --out public
+
+      - name: Verify generated static portal assets
+        run: |
+          test -f public/index.html
+          test -f public/data.json

eidos_ai-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,79 @@
+name: Release to PyPI
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build package distributions 📦
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v7
+
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v10.3.0
+        with:
+          enable-cache: true
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.12
+
+      - name: Build sdist and wheel
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  publish-to-pypi:
+    name: Publish to PyPI 🚀
+    needs: [build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/eidos-ai
+    permissions:
+      id-token: write # Required for PyPI Trusted Publishing (OIDC)
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          skip-existing: true
+
+  github-release:
+    name: Attach assets to GitHub Release 🏷️
+    needs: [build]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v') || github.event_name == 'release'
+    permissions:
+      contents: write
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v8
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Upload artifacts to GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          files: dist/*

eidos_ai-0.1.0/.gitignore

@@ -0,0 +1,25 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Testing & Coverage
+.pytest_cache/
+.coverage
+htmlcov/
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+
+# Local agent plugins installation
+.agents/
+.cursor/
+.claude/
+

eidos_ai-0.1.0/.vscode/python.code-snippets

@@ -0,0 +1,205 @@
+{
+    "if": {
+        "scope": "python",
+        "prefix": "if",
+        "body": ["if ${1:expression}:", "\t${2:pass}"],
+        "description": "Code snippet for an if statement"
+    },
+    "if/else": {
+        "scope": "python",
+        "prefix": "if/else",
+        "body": ["if ${1:condition}:", "\t${2:pass}", "else:", "\t${3:pass}"],
+        "description": "Code snippet for an if statement with else"
+    },
+    "elif": {
+        "scope": "python",
+        "prefix": "elif",
+        "body": ["elif ${1:expression}:", "\t${2:pass}"],
+        "description": "Code snippet for an elif"
+    },
+    "else": {
+        "scope": "python",
+        "prefix": "else",
+        "body": ["else:", "\t${1:pass}"],
+        "description": "Code snippet for an else"
+    },
+    "while": {
+        "scope": "python",
+        "prefix": "while",
+        "body": ["while ${1:expression}:", "\t${2:pass}"],
+        "description": "Code snippet for a while loop"
+    },
+    "while/else": {
+        "scope": "python",
+        "prefix": "while/else",
+        "body": ["while ${1:expression}:", "\t${2:pass}", "else:", "\t${3:pass}"],
+        "description": "Code snippet for a while loop with else"
+    },
+    "for": {
+        "scope": "python",
+        "prefix": "for",
+        "body": ["for ${1:target_list} in ${2:expression_list}:", "\t${3:pass}"],
+        "description": "Code snippet for a for loop"
+    },
+    "for/else": {
+        "scope": "python",
+        "prefix": "for/else",
+        "body": ["for ${1:target_list} in ${2:expression_list}:", "\t${3:pass}", "else:", "\t${4:pass}"],
+        "description": "Code snippet for a for loop with else"
+    },
+    "try/except": {
+        "scope": "python",
+        "prefix": "try/except",
+        "body": ["try:", "\t${1:pass}", "except ${2:expression} as ${3:identifier}:", "\t${4:pass}"],
+        "description": "Code snippet for a try/except statement"
+    },
+    "try/finally": {
+        "scope": "python",
+        "prefix": "try/finally",
+        "body": ["try:", "\t${1:pass}", "finally:", "\t${2:pass}"],
+        "description": "Code snippet for a try/finally statement"
+    },
+    "try/except/else": {
+        "scope": "python",
+        "prefix": "try/except/else",
+        "body": [
+            "try:",
+            "\t${1:pass}",
+            "except ${2:expression} as ${3:identifier}:",
+            "\t${4:pass}",
+            "else:",
+            "\t${5:pass}"
+        ],
+        "description": "Code snippet for a try/except/else statement"
+    },
+    "try/except/finally": {
+        "scope": "python",
+        "prefix": "try/except/finally",
+        "body": [
+            "try:",
+            "\t${1:pass}",
+            "except ${2:expression} as ${3:identifier}:",
+            "\t${4:pass}",
+            "finally:",
+            "\t${5:pass}"
+        ],
+        "description": "Code snippet for a try/except/finally statement"
+    },
+    "try/except/else/finally": {
+        "scope": "python",
+        "prefix": "try/except/else/finally",
+        "body": [
+            "try:",
+            "\t${1:pass}",
+            "except ${2:expression} as ${3:identifier}:",
+            "\t${4:pass}",
+            "else:",
+            "\t${5:pass}",
+            "finally:",
+            "\t${6:pass}"
+        ],
+        "description": "Code snippet for a try/except/else/finally statement"
+    },
+    "with": {
+        "scope": "python",
+        "prefix": "with",
+        "body": ["with ${1:expression} as ${2:target}:", "\t${3:pass}"],
+        "description": "Code snippet for a with statement"
+    },
+    "def": {
+        "scope": "python",
+        "prefix": "def",
+        "body": ["def ${1:funcname}(${2:parameter_list}):", "\t\"\"\"", "\t${3:docstring}", "\t\"\"\"", "\t${4:pass}"],
+        "description": "Code snippet for a function definition"
+    },
+    "def(class method)": {
+        "scope": "python",
+        "prefix": "def(class method)",
+        "body": ["def ${1:funcname}(self, ${2:parameter_list}):", "\t\"\"\"", "\t${3:docstring}", "\t\"\"\"", "\t${4:pass}"],
+        "description": "Code snippet for a class method"
+    },
+    "def(static class method)": {
+        "scope": "python",
+        "prefix": "def(static class method)",
+        "body": ["@staticmethod", "def ${1:funcname}(${2:parameter_list}):", "\t\"\"\"", "\t${3:docstring}", "\t\"\"\"", "\t${4:pass}"],
+        "description": "Code snippet for a static class method"
+    },
+    "def(abstract class method)": {
+        "scope": "python",
+        "prefix": "def(abstract class method)",
+        "body": ["def ${1:funcname}(self, ${2:parameter_list}):", "\t\"\"\"", "\t${3:docstring}", "\t\"\"\"", "\traise NotImplementedError"],
+        "description": "Code snippet for an abstract class method"
+    },
+    "class": {
+        "scope": "python",
+        "prefix": "class",
+        "body": ["class ${1:classname}(${2:object}):", "\t\"\"\"", "\t${3:docstring}", "\t\"\"\"", "\t${4:pass}"],
+        "description": "Code snippet for a class definition"
+    },
+    "lambda": {
+        "scope": "python",
+        "prefix": "lambda",
+        "body": ["lambda ${1:parameter_list}: ${2:expression}"],
+        "description": "Code snippet for a lambda statement"
+    },
+    "if(main)": {
+        "scope": "python",
+        "prefix": "__main__",
+        "body": ["if __name__ == \"__main__\":", "    ${1:pass}"],
+        "description": "Code snippet for a `if __name__ == \"__main__\": ...` block"
+    },
+    "async/def": {
+        "scope": "python",
+        "prefix": "async/def",
+        "body": ["async def ${1:funcname}(${2:parameter_list}):", "\t${3:pass}"],
+        "description": "Code snippet for an async function definition"
+    },
+    "async/for": {
+        "scope": "python",
+        "prefix": "async/for",
+        "body": ["async for ${1:target} in ${2:iter}:", "\t${3:block}"],
+        "description": "Code snippet for an async for statement"
+    },
+    "async/for/else": {
+        "scope": "python",
+        "prefix": "async/for/else",
+        "body": ["async for ${1:target} in ${2:iter}:", "\t${3:block}", "else:", "\t${4:block}"],
+        "description": "Code snippet for an async for statement with else"
+    },
+    "async/with": {
+        "scope": "python",
+        "prefix": "async/with",
+        "body": ["async with ${1:expr} as ${2:var}:", "\t${3:block}"],
+        "description": "Code snippet for an async with statement"
+    },
+    "ipdb": {
+        "scope": "python",
+        "prefix": "ipdb",
+        "body": "import ipdb; ipdb.set_trace()",
+        "description": "Code snippet for ipdb debug"
+    },
+    "pdb": {
+        "scope": "python",
+        "prefix": "pdb",
+        "body": "import pdb; pdb.set_trace()",
+        "description": "Code snippet for pdb debug"
+    },
+    "pudb": {
+        "scope": "python",
+        "prefix": "pudb",
+        "body": "import pudb; pudb.set_trace()",
+        "description": "Code snippet for pudb debug"
+    },
+    "add/new/cell": {
+        "scope": "python",
+        "prefix": "add/new/cell",
+        "body": "# %%",
+        "description": "Code snippet to add a new cell"
+    },
+    "mark/markdown": {
+        "scope": "python",
+        "prefix": "mark/markdown",
+        "body": "# %% [markdown]",
+        "description": "Code snippet to add a new markdown cell"
+    }
+}

eidos_ai-0.1.0/.vscode/settings.json

@@ -0,0 +1,24 @@
+{
+  "remote.autoForwardPortsSource": "process",
+  "python-envs.defaultEnvManager": "ms-python.python:system",
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python",
+  "python.languageServer": "None",
+  "python.testing.pytestEnabled": true,
+  "python.testing.pytestArgs": [
+    "tests"
+  ],
+  "[python]": {
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.formatOnSave": true,
+    "editor.codeActionsOnSave": {
+      "source.fixAll": "explicit",
+      "source.organizeImports": "explicit"
+    }
+  },
+  "editor.formatOnSave": true,
+  "files.eol": "\n",
+  "files.trimTrailingWhitespace": true,
+  "files.insertFinalNewline": true,
+  "asciidoc.extensions.enableKroki": true,
+  "asciidoc.extensions.kroki.serverUrl": "https://kroki.io"
+}

eidos_ai-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eidos Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eidos_ai-0.1.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: eidos-ai
+Version: 0.1.0
+Summary: Git-Native, Agent-Agnostic Development AI Ecosystem & Lifecycle Orchestrator
+Author: Eidos Contributors
+License: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: jsonschema>=4.20.0
+Requires-Dist: pydantic>=2.7.0
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: rich>=13.7.0
+Requires-Dist: typer>=0.12.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.4.0; extra == 'dev'
+Description-Content-Type: text/plain
+
+= Eidos: Git-Native AI Software Development Ecosystem
+:toc: left
+:icons: font
+:source-highlighter: highlight.js
+
+Eidos is an open, Git-native, agent-agnostic development framework designed to unify product definition, architectural invariants, and autonomous coding agents under executable specifications.
+
+This repository dogfoods the **Eidos Specification Standard** to define Eidos itself.
+
+== Repository Architecture
+
+[source,text]
+----
+eidos/
+├── pyproject.toml                 # Modern Python package definition (uv/hatchling)
+│
+├── src/eidos/                     # [THE ENGINE / SOLUTION]
+│   ├── cli/                       # CLI commands (`eidos validate`, `eidos delta`, etc.)
+│   ├── core/                      # AsciiDoc + YAML frontmatter parser & validator
+│   ├── agent/                     # Pluggable agent adapters (agy, claude, codex)
+│   ├── vcs/                       # GitHub & GitLab sync engine
+│   └── schemas/v1/                # Portable JSON/YAML Schemas bundled as package data
+│       ├── product/               # Product definition schemas
+│       │   ├── system.schema.yaml
+│       │   ├── domain.schema.yaml
+│       │   ├── capability.schema.yaml
+│       │   ├── policy.schema.yaml
+│       │   ├── persona.schema.yaml
+│       │   └── exploration.schema.yaml
+│       ├── tech/                  # Technical architecture schemas
+│       │   ├── architecture.schema.yaml
+│       │   ├── component.schema.yaml
+│       │   └── contract.schema.yaml
+│       └── delta/                 # Mutation & evolution schemas
+│           └── delta.schema.yaml
+│
+├── eidos/                         # [THE LIVING SPECIFICATION / REAL USAGE]
+│   ├── system.adoc                # Root system descriptor
+│   ├── personas/                  # Human & AI actor roles
+│   ├── policies/                  # Non-negotiable architectural invariants
+│   ├── domains/                   # Bounded contexts & capabilities
+│   ├── architecture/              # System architecture, components, & contracts
+│   └── deltas/                    # In-flight and applied mutations
+│
+└── tests/                         # Engine & specification test suites
+----
+
+== Key Distinctions from Existing Tools
+
+[cols="1,2,2", options="header"]
+|===
+| Dimension | Traditional / Existing Tools | Eidos Approach
+| **Scope** | Coding loop only (Aider, Claude Code) or monolithic bot (Devin) | Full SDLC: Exploration -> Product Baseline -> SpecDelta -> Code -> CI
+| **Specifications** | Ephemeral Jira tickets, stale Confluence/Notion pages | Versioned YAML frontmatter + AsciiDoc living in Git
+| **Change Management** | Narrative RFC essays that rot in archive folders | Declarative `SpecDelta` mutations applied automatically upon merge
+| **Agent Support** | Vendor-locked to a single proprietary LLM | Pluggable adapter layer supporting `agy`, Claude Code, Codex, Copilot
+| **VCS Support** | GitHub-only or closed web UI | Native bidirectional support for both GitHub and GitLab
+|===
+
+== Navigating the Specifications
+
+* **Root System**: Link to link:file://eidos/system.adoc[`system.adoc`]
+* **Product Domains**:
+** Link to link:file://eidos/domains/product-core/domain.adoc[`Product Intelligence Domain`]
+** Link to link:file://eidos/domains/agent-harness/domain.adoc[`Agent Harness Domain`]
+** Link to link:file://eidos/domains/vcs-sync/domain.adoc[`VCS Sync Domain`]
+* **Policies**:
+** Link to link:file://eidos/policies/POL-001-git-as-single-source-of-truth.adoc[`POL-001: Git Source of Truth`]
+** Link to link:file://eidos/policies/POL-002-invariant-test-enforcement.adoc[`POL-002: Invariant Test Enforcement`]
+* **Technical Architecture**:
+** Link to link:file://eidos/architecture/system-architecture.adoc[`Global System Architecture`]
+** Link to link:file://eidos/architecture/components/engine.adoc[`Component: Eidos Engine`]
+** Link to link:file://eidos/architecture/contracts/cli.adoc[`Contract: Eidos CLI`]
+
+== License
+
+Licensed under the link:LICENSE[MIT License].