awara 0.0.0__tar.gz

awara-0.0.0/.gitignore

@@ -0,0 +1,8 @@
+.venv/
+__pycache__/
+dist/
+*.egg-info/
+node_modules/
+target/
+*.tgz
+.DS_Store

awara-0.0.0/LICENSE

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

awara-0.0.0/PKG-INFO

@@ -0,0 +1,49 @@
+Metadata-Version: 2.5
+Name: awara
+Version: 0.0.0
+Summary: Portable creative workflow recipe schema and validator
+Project-URL: Repository, https://github.com/orbyts/awara
+Author: Suhail Suhail
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: jsonschema<5,>=4.23
+Description-Content-Type: text/markdown
+
+# Awara
+
+Portable creative workflow recipes, schemas, and validation tools.
+
+Version 0.0.0 is a functional experimental release: validate a recipe, export its JSON Schema, or use the validator as a library. It does not configure Resolve, ingest media, apply LUTs, or verify color accuracy. Settings are application-defined data, not checked against application APIs.
+
+## CLI
+
+```sh
+awara validate examples/resolve-manual-dwg.json
+awara schema
+awara --version
+```
+
+Exit codes: 0 valid/success, 1 schema validation failed, 2 file/JSON/usage error.
+
+Python: `uv tool install awara`. JavaScript: `npx awara validate recipe.json`. Rust: `cargo install awara`. Each provides the same command name; install one CLI implementation per environment.
+
+## Libraries and website use
+
+Python: `from awara import validate, schema`.
+JavaScript: `import {validate, schema} from 'awara'` (browser-bundler compatible).
+Rust: `awara::validate(&serde_json::Value)` and `awara::SCHEMA`.
+
+Validation is read-only and never executes recipe steps. The JavaScript library has no Node filesystem dependency; filesystem access is confined to its CLI. A website can use the same schema for forms and validation later.
+
+## Ownership
+
+Awara describes reusable application workflows. Kairo owns device identities/capture settings. Kestreel owns ingestion/project scaffolding and may consume Awara recipes. No paid LUTs, plugins, personal media, or credentials are distributed here.
+
+## Development
+
+`uv run python -m unittest discover -s tests`; `cd js && npm ci && npm test`; `cargo test --manifest-path rust/Cargo.toml`.
+
+The canonical schema lives in `schemas/recipe.schema.json`; package copies must match. Shared contract fixtures test all three implementations. Schema version 1 is experimental and may evolve before a stable release.
+
+MIT licensed.

awara-0.0.0/README.md

@@ -0,0 +1,37 @@
+# Awara
+
+Portable creative workflow recipes, schemas, and validation tools.
+
+Version 0.0.0 is a functional experimental release: validate a recipe, export its JSON Schema, or use the validator as a library. It does not configure Resolve, ingest media, apply LUTs, or verify color accuracy. Settings are application-defined data, not checked against application APIs.
+
+## CLI
+
+```sh
+awara validate examples/resolve-manual-dwg.json
+awara schema
+awara --version
+```
+
+Exit codes: 0 valid/success, 1 schema validation failed, 2 file/JSON/usage error.
+
+Python: `uv tool install awara`. JavaScript: `npx awara validate recipe.json`. Rust: `cargo install awara`. Each provides the same command name; install one CLI implementation per environment.
+
+## Libraries and website use
+
+Python: `from awara import validate, schema`.
+JavaScript: `import {validate, schema} from 'awara'` (browser-bundler compatible).
+Rust: `awara::validate(&serde_json::Value)` and `awara::SCHEMA`.
+
+Validation is read-only and never executes recipe steps. The JavaScript library has no Node filesystem dependency; filesystem access is confined to its CLI. A website can use the same schema for forms and validation later.
+
+## Ownership
+
+Awara describes reusable application workflows. Kairo owns device identities/capture settings. Kestreel owns ingestion/project scaffolding and may consume Awara recipes. No paid LUTs, plugins, personal media, or credentials are distributed here.
+
+## Development
+
+`uv run python -m unittest discover -s tests`; `cd js && npm ci && npm test`; `cargo test --manifest-path rust/Cargo.toml`.
+
+The canonical schema lives in `schemas/recipe.schema.json`; package copies must match. Shared contract fixtures test all three implementations. Schema version 1 is experimental and may evolve before a stable release.
+
+MIT licensed.

awara-0.0.0/js/LICENSE

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

awara-0.0.0/js/README.md

@@ -0,0 +1,37 @@
+# Awara
+
+Portable creative workflow recipes, schemas, and validation tools.
+
+Version 0.0.0 is a functional experimental release: validate a recipe, export its JSON Schema, or use the validator as a library. It does not configure Resolve, ingest media, apply LUTs, or verify color accuracy. Settings are application-defined data, not checked against application APIs.
+
+## CLI
+
+```sh
+awara validate examples/resolve-manual-dwg.json
+awara schema
+awara --version
+```
+
+Exit codes: 0 valid/success, 1 schema validation failed, 2 file/JSON/usage error.
+
+Python: `uv tool install awara`. JavaScript: `npx awara validate recipe.json`. Rust: `cargo install awara`. Each provides the same command name; install one CLI implementation per environment.
+
+## Libraries and website use
+
+Python: `from awara import validate, schema`.
+JavaScript: `import {validate, schema} from 'awara'` (browser-bundler compatible).
+Rust: `awara::validate(&serde_json::Value)` and `awara::SCHEMA`.
+
+Validation is read-only and never executes recipe steps. The JavaScript library has no Node filesystem dependency; filesystem access is confined to its CLI. A website can use the same schema for forms and validation later.
+
+## Ownership
+
+Awara describes reusable application workflows. Kairo owns device identities/capture settings. Kestreel owns ingestion/project scaffolding and may consume Awara recipes. No paid LUTs, plugins, personal media, or credentials are distributed here.
+
+## Development
+
+`uv run python -m unittest discover -s tests`; `cd js && npm ci && npm test`; `cargo test --manifest-path rust/Cargo.toml`.
+
+The canonical schema lives in `schemas/recipe.schema.json`; package copies must match. Shared contract fixtures test all three implementations. Schema version 1 is experimental and may evolve before a stable release.
+
+MIT licensed.

awara-0.0.0/pyproject.toml

@@ -0,0 +1,19 @@
+[project]
+name = "awara"
+version = "0.0.0"
+description = "Portable creative workflow recipe schema and validator"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [{name = "Suhail Suhail"}]
+dependencies = ["jsonschema>=4.23,<5"]
+[project.urls]
+Repository = "https://github.com/orbyts/awara"
+[project.scripts]
+awara = "awara:main"
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.sdist]
+include = ["src/awara", "README.md", "LICENSE", "pyproject.toml"]

awara-0.0.0/rust/LICENSE

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

awara-0.0.0/rust/README.md

@@ -0,0 +1,37 @@
+# Awara
+
+Portable creative workflow recipes, schemas, and validation tools.
+
+Version 0.0.0 is a functional experimental release: validate a recipe, export its JSON Schema, or use the validator as a library. It does not configure Resolve, ingest media, apply LUTs, or verify color accuracy. Settings are application-defined data, not checked against application APIs.
+
+## CLI
+
+```sh
+awara validate examples/resolve-manual-dwg.json
+awara schema
+awara --version
+```
+
+Exit codes: 0 valid/success, 1 schema validation failed, 2 file/JSON/usage error.
+
+Python: `uv tool install awara`. JavaScript: `npx awara validate recipe.json`. Rust: `cargo install awara`. Each provides the same command name; install one CLI implementation per environment.
+
+## Libraries and website use
+
+Python: `from awara import validate, schema`.
+JavaScript: `import {validate, schema} from 'awara'` (browser-bundler compatible).
+Rust: `awara::validate(&serde_json::Value)` and `awara::SCHEMA`.
+
+Validation is read-only and never executes recipe steps. The JavaScript library has no Node filesystem dependency; filesystem access is confined to its CLI. A website can use the same schema for forms and validation later.
+
+## Ownership
+
+Awara describes reusable application workflows. Kairo owns device identities/capture settings. Kestreel owns ingestion/project scaffolding and may consume Awara recipes. No paid LUTs, plugins, personal media, or credentials are distributed here.
+
+## Development
+
+`uv run python -m unittest discover -s tests`; `cd js && npm ci && npm test`; `cargo test --manifest-path rust/Cargo.toml`.
+
+The canonical schema lives in `schemas/recipe.schema.json`; package copies must match. Shared contract fixtures test all three implementations. Schema version 1 is experimental and may evolve before a stable release.
+
+MIT licensed.

awara-0.0.0/src/awara/__init__.py

@@ -0,0 +1,39 @@
+"""Portable Awara workflow recipe validation."""
+
+import argparse
+import json
+from importlib.resources import files
+from pathlib import Path
+
+from jsonschema import Draft202012Validator
+
+
+def schema() -> dict:
+    return json.loads(files(__package__).joinpath("recipe.schema.json").read_text())
+
+
+def validate(recipe: object) -> list[str]:
+    """Return schema errors; an empty list means structurally valid."""
+    return [
+        f"{list(e.absolute_path)}: {e.message}"
+        for e in Draft202012Validator(schema()).iter_errors(recipe)
+    ]
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("--version", action="version", version="awara 0.0.0")
+    sub = parser.add_subparsers(dest="command", required=True)
+    sub.add_parser("schema")
+    sub.add_parser("validate").add_argument("file", type=Path)
+    args = parser.parse_args()
+    if args.command == "schema":
+        print(json.dumps(schema(), indent=2))
+        return 0
+    try:
+        errors = validate(json.loads(args.file.read_text()))
+    except (OSError, ValueError) as exc:
+        print(f"Error: {exc}")
+        return 2
+    print("\n".join(errors) if errors else "Valid Awara recipe")
+    return int(bool(errors))

awara-0.0.0/src/awara/recipe.schema.json

@@ -0,0 +1,75 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/orbyts/awara/main/schemas/recipe.schema.json",
+  "title": "Awara workflow recipe v1",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "id",
+    "version",
+    "application",
+    "steps"
+  ],
+  "properties": {
+    "schema_version": {
+      "const": 1
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9-]*$"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$"
+    },
+    "description": {
+      "type": "string"
+    },
+    "application": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "id"
+      ],
+      "properties": {
+        "id": {
+          "type": "string",
+          "minLength": 1
+        },
+        "settings": {
+          "type": "object"
+        }
+      }
+    },
+    "steps": {
+      "type": "array",
+      "minItems": 1,
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": [
+          "id",
+          "mode",
+          "description"
+        ],
+        "properties": {
+          "id": {
+            "type": "string",
+            "minLength": 1
+          },
+          "mode": {
+            "enum": [
+              "manual",
+              "automated"
+            ]
+          },
+          "description": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
+    }
+  }
+}