codio-tools 0.1.0__tar.gz

codio_tools-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arash Shahidi
+
+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.

codio_tools-0.1.0/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: codio-tools
+Version: 0.1.0
+Summary: Code intelligence and reuse discovery for research repositories
+Author: Arash Shahidi
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/arashshahidi1997/codio
+Project-URL: Repository, https://github.com/arashshahidi1997/codio
+Project-URL: Issues, https://github.com/arashshahidi1997/codio/issues
+Keywords: code,reuse,discovery,library,registry,intelligence
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: pydantic>=2.0
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: license-file
+
+# codio
+
+Code intelligence and reuse discovery for research repositories.
+
+Codio answers a practical question before implementation begins:
+*What code already exists that solves this problem?*
+
+It maintains a two-layer registry — a **catalog** of library identity (name, language, repo, license) and a **project profile** of local policy (priority, runtime import rules, capability tags) — so agents and humans can search before they build.
+
+## Install
+
+```bash
+pip install codio
+```
+
+## Quick start
+
+```bash
+codio init                          # scaffold .codio/ in your project
+codio list                          # list registered libraries
+codio discover "signal-processing"  # search by capability
+codio get mylib                     # full library record
+codio validate                      # check registry consistency
+codio vocab                         # show controlled vocabulary
+codio study mylib                   # structured library analysis
+codio compare lib1 lib2             # compare libraries side-by-side
+```
+
+## Registry model
+
+Codio separates **what a library is** from **how your project uses it**:
+
+- **Catalog** (`.codio/catalog.yml`) — shared, project-agnostic metadata: name, kind, language, repo URL, package name, license, local source paths.
+- **Profile** (`.codio/profiles.yml`) — project-local interpretation: priority tier, runtime import policy, decision default, capability tags, curated note path.
+
+Fields use a controlled vocabulary (`codio vocab`): `kind` (internal, external_mirror, utility), `runtime_import` (internal, pip_only, reference_only), `decision_default` (existing, wrap, direct, new), `priority` (tier1, tier2, ...).
+
+## MCP integration
+
+Codio exposes tools through the projio MCP server:
+
+| Tool | Description |
+|------|-------------|
+| `codio_list` | Filtered library listing |
+| `codio_get` | Full library record |
+| `codio_registry` | Full registry snapshot |
+| `codio_vocab` | Controlled vocabulary |
+| `codio_validate` | Registry consistency check |
+| `codio_discover` | Capability search across libraries |
+| `codio_add_urls` | Add libraries from GitHub/GitLab URLs |
+
+## Agent skills
+
+- **codelib-discovery** — search before implement: returns candidates with evidence and recommends a decision (reuse, wrap, depend, or implement new).
+- **codelib-update** — maintain registry and curated notes.
+- **library-study** — deep parallel analysis of external libraries.
+
+## Ecosystem
+
+Codio is part of the [projio](https://github.com/arashshahidi1997/projio) ecosystem alongside [indexio](https://github.com/arashshahidi1997/indexio) (semantic search), [biblio](https://github.com/arashshahidi1997/biblio) (bibliography), and [notio](https://github.com/arashshahidi1997/notio) (structured notes).
+
+## Documentation
+
+See the [full documentation](docs/index.md) for tutorials, how-to guides, and reference.
+
+```bash
+pip install codio[dev]
+mkdocs serve
+```

codio_tools-0.1.0/README.md

@@ -0,0 +1,69 @@
+# codio
+
+Code intelligence and reuse discovery for research repositories.
+
+Codio answers a practical question before implementation begins:
+*What code already exists that solves this problem?*
+
+It maintains a two-layer registry — a **catalog** of library identity (name, language, repo, license) and a **project profile** of local policy (priority, runtime import rules, capability tags) — so agents and humans can search before they build.
+
+## Install
+
+```bash
+pip install codio
+```
+
+## Quick start
+
+```bash
+codio init                          # scaffold .codio/ in your project
+codio list                          # list registered libraries
+codio discover "signal-processing"  # search by capability
+codio get mylib                     # full library record
+codio validate                      # check registry consistency
+codio vocab                         # show controlled vocabulary
+codio study mylib                   # structured library analysis
+codio compare lib1 lib2             # compare libraries side-by-side
+```
+
+## Registry model
+
+Codio separates **what a library is** from **how your project uses it**:
+
+- **Catalog** (`.codio/catalog.yml`) — shared, project-agnostic metadata: name, kind, language, repo URL, package name, license, local source paths.
+- **Profile** (`.codio/profiles.yml`) — project-local interpretation: priority tier, runtime import policy, decision default, capability tags, curated note path.
+
+Fields use a controlled vocabulary (`codio vocab`): `kind` (internal, external_mirror, utility), `runtime_import` (internal, pip_only, reference_only), `decision_default` (existing, wrap, direct, new), `priority` (tier1, tier2, ...).
+
+## MCP integration
+
+Codio exposes tools through the projio MCP server:
+
+| Tool | Description |
+|------|-------------|
+| `codio_list` | Filtered library listing |
+| `codio_get` | Full library record |
+| `codio_registry` | Full registry snapshot |
+| `codio_vocab` | Controlled vocabulary |
+| `codio_validate` | Registry consistency check |
+| `codio_discover` | Capability search across libraries |
+| `codio_add_urls` | Add libraries from GitHub/GitLab URLs |
+
+## Agent skills
+
+- **codelib-discovery** — search before implement: returns candidates with evidence and recommends a decision (reuse, wrap, depend, or implement new).
+- **codelib-update** — maintain registry and curated notes.
+- **library-study** — deep parallel analysis of external libraries.
+
+## Ecosystem
+
+Codio is part of the [projio](https://github.com/arashshahidi1997/projio) ecosystem alongside [indexio](https://github.com/arashshahidi1997/indexio) (semantic search), [biblio](https://github.com/arashshahidi1997/biblio) (bibliography), and [notio](https://github.com/arashshahidi1997/notio) (structured notes).
+
+## Documentation
+
+See the [full documentation](docs/index.md) for tutorials, how-to guides, and reference.
+
+```bash
+pip install codio[dev]
+mkdocs serve
+```

codio_tools-0.1.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "codio-tools"
+version = "0.1.0"
+description = "Code intelligence and reuse discovery for research repositories"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Arash Shahidi" }]
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["code", "reuse", "discovery", "library", "registry", "intelligence"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: Console",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Scientific/Engineering :: Information Analysis",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = ["pyyaml>=6.0", "pydantic>=2.0"]
+
+[project.urls]
+Homepage = "https://github.com/arashshahidi1997/codio"
+Repository = "https://github.com/arashshahidi1997/codio"
+Issues = "https://github.com/arashshahidi1997/codio/issues"
+
+[project.scripts]
+codio = "codio.cli:main"
+
+[project.optional-dependencies]
+dev = ["pytest", "build", "twine"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+codio = ["templates/**/*.tmpl"]

codio_tools-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

codio_tools-0.1.0/src/codio/__init__.py

@@ -0,0 +1,56 @@
+"""Top-level package for codio."""
+
+from codio.config import CodioConfig, load_config
+from codio.models import (
+    CodeSourceEntry,
+    LibraryCatalogEntry,
+    LibraryRecord,
+    ProjectProfileEntry,
+    RegistrySnapshot,
+    RepositoryEntry,
+    ValidationResult,
+)
+from codio.paths import find_project_root
+from codio.registry import Registry, load_catalog, load_profiles, load_repos
+from codio.scaffold import ScaffoldResult, init_codio_scaffold
+from codio.vocab import (
+    AddedBy,
+    DecisionDefault,
+    Hosting,
+    Kind,
+    Priority,
+    RuntimeImport,
+    SourceType,
+    Status,
+    Storage,
+    get_vocab,
+)
+
+__all__ = [
+    "AddedBy",
+    "CodeSourceEntry",
+    "CodioConfig",
+    "DecisionDefault",
+    "Hosting",
+    "Kind",
+    "LibraryCatalogEntry",
+    "LibraryRecord",
+    "Priority",
+    "ProjectProfileEntry",
+    "Registry",
+    "RegistrySnapshot",
+    "RepositoryEntry",
+    "RuntimeImport",
+    "ScaffoldResult",
+    "SourceType",
+    "Status",
+    "Storage",
+    "ValidationResult",
+    "find_project_root",
+    "get_vocab",
+    "init_codio_scaffold",
+    "load_catalog",
+    "load_config",
+    "load_profiles",
+    "load_repos",
+]