@aionis/manifest 0.1.1

package/dist/validate.d.ts

@@ -0,0 +1,52 @@
+export declare const AIONIS_MANIFEST_REGISTRY_VALIDATION_RESULT_VERSION: "aionis_manifest_registry_validation_result_v1";
+export declare const AIONIS_MANIFEST_MODULE_VALIDATION_RESULT_VERSION: "aionis_manifest_module_validation_result_v1";
+type ModuleValidationSummary = {
+    module: string;
+    version: string;
+    title: string | null;
+    deterministic: boolean | null;
+    required_capabilities: string[];
+};
+export type AionisManifestModuleValidationResult = {
+    command: "validate-aionis-manifest-module";
+    validation_result_version: typeof AIONIS_MANIFEST_MODULE_VALIDATION_RESULT_VERSION;
+    valid: true;
+    entry_path: string;
+    declared_module: string | null;
+    module: ModuleValidationSummary;
+};
+export type AionisManifestRegistryValidationResult = {
+    command: "validate-aionis-manifest-registry";
+    validation_result_version: typeof AIONIS_MANIFEST_REGISTRY_VALIDATION_RESULT_VERSION;
+    valid: true;
+    registry_path: string;
+    registry_version: string;
+    runtime_id: "standalone_file_registry_v1" | "standalone_npm_registry_v1";
+    module_count: number;
+    modules: Array<{
+        module: string;
+        source: "file";
+        entry: string;
+        resolved_target: string;
+        manifest: ModuleValidationSummary;
+    } | {
+        module: string;
+        source: "package";
+        package: string;
+        export: string | null;
+        specifier: string;
+        resolved_target: string;
+        manifest: ModuleValidationSummary;
+    }>;
+};
+export declare function validateAionisManifestModule(args: {
+    entryPath: string;
+    declaredModule?: string;
+    cwd?: string;
+}): Promise<AionisManifestModuleValidationResult>;
+export declare function validateAionisManifestRegistry(args: {
+    registryPath: string;
+}): Promise<AionisManifestRegistryValidationResult>;
+export declare function writeValidationOutput(pathname: string, contents: string): Promise<void>;
+export declare function resolveOutputPath(target: string): string;
+export {};

package/dist/validate.js

@@ -0,0 +1,91 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve as resolvePath } from "node:path";
+import { loadModuleDefinitionFromFileEntry, loadModuleDefinitionFromNpmEntry, loadModuleRegistryFile, } from "./registry/loadModuleRegistry.js";
+import { AIONIS_MANIFEST_MODULE_REGISTRY_VERSION, } from "./registry/types.js";
+import { validateExecutionModuleManifest } from "./contracts.js";
+export const AIONIS_MANIFEST_REGISTRY_VALIDATION_RESULT_VERSION = "aionis_manifest_registry_validation_result_v1";
+export const AIONIS_MANIFEST_MODULE_VALIDATION_RESULT_VERSION = "aionis_manifest_module_validation_result_v1";
+function summarizeManifest(manifest) {
+    const parsed = validateExecutionModuleManifest(manifest);
+    return {
+        module: parsed.module,
+        version: parsed.version,
+        title: parsed.title ?? null,
+        deterministic: typeof parsed.deterministic === "boolean" ? parsed.deterministic : null,
+        required_capabilities: parsed.required_capabilities ?? [],
+    };
+}
+export async function validateAionisManifestModule(args) {
+    const registryDir = args.cwd ?? process.cwd();
+    const entry = {
+        module: args.declaredModule,
+        entry: args.entryPath,
+    };
+    const loaded = await loadModuleDefinitionFromFileEntry({ registryDir, entry });
+    if (args.declaredModule && loaded.definition.manifest.module !== args.declaredModule) {
+        throw new Error(`Entry '${loaded.resolvedEntryPath}' exports manifest '${loaded.definition.manifest.module}' but declared module was '${args.declaredModule}'.`);
+    }
+    return {
+        command: "validate-aionis-manifest-module",
+        validation_result_version: AIONIS_MANIFEST_MODULE_VALIDATION_RESULT_VERSION,
+        valid: true,
+        entry_path: loaded.resolvedEntryPath,
+        declared_module: args.declaredModule ?? null,
+        module: summarizeManifest(loaded.definition.manifest),
+    };
+}
+export async function validateAionisManifestRegistry(args) {
+    const registry = await loadModuleRegistryFile(args.registryPath);
+    const registryDir = dirname(args.registryPath);
+    if (registry.version === AIONIS_MANIFEST_MODULE_REGISTRY_VERSION) {
+        const modules = await Promise.all(registry.modules.map(async (entry) => {
+            const loaded = await loadModuleDefinitionFromFileEntry({ registryDir, entry });
+            return {
+                module: entry.module,
+                source: "file",
+                entry: entry.entry,
+                resolved_target: loaded.resolvedEntryPath,
+                manifest: summarizeManifest(loaded.definition.manifest),
+            };
+        }));
+        return {
+            command: "validate-aionis-manifest-registry",
+            validation_result_version: AIONIS_MANIFEST_REGISTRY_VALIDATION_RESULT_VERSION,
+            valid: true,
+            registry_path: args.registryPath,
+            registry_version: registry.version,
+            runtime_id: "standalone_file_registry_v1",
+            module_count: modules.length,
+            modules,
+        };
+    }
+    const modules = await Promise.all(registry.modules.map(async (entry) => {
+        const loaded = await loadModuleDefinitionFromNpmEntry({ registryDir, entry });
+        return {
+            module: entry.module,
+            source: "package",
+            package: entry.package,
+            export: entry.export ?? null,
+            specifier: loaded.specifier,
+            resolved_target: loaded.resolvedEntryPath,
+            manifest: summarizeManifest(loaded.definition.manifest),
+        };
+    }));
+    return {
+        command: "validate-aionis-manifest-registry",
+        validation_result_version: AIONIS_MANIFEST_REGISTRY_VALIDATION_RESULT_VERSION,
+        valid: true,
+        registry_path: args.registryPath,
+        registry_version: registry.version,
+        runtime_id: "standalone_npm_registry_v1",
+        module_count: modules.length,
+        modules,
+    };
+}
+export async function writeValidationOutput(pathname, contents) {
+    await mkdir(dirname(pathname), { recursive: true });
+    await writeFile(pathname, contents, "utf8");
+}
+export function resolveOutputPath(target) {
+    return resolvePath(process.cwd(), target);
+}

package/fixtures/duplicate-doc.aionis.md

@@ -0,0 +1,19 @@
+@manifest {
+  id: "primary-doc"
+  version: "1.0"
+}
+
+@manifest {
+  id: "secondary-doc"
+  version: "2.0"
+}
+
+@context {
+  objective: "Trigger duplicate manifest diagnostic"
+}
+
+@execute {
+  module: "demo.duplicate.v1"
+  input_ref: "ctx"
+  output_ref: "out.duplicate"
+}

package/fixtures/fenced-example.aionis.md

@@ -0,0 +1,27 @@
+```text
+@manifest {
+  id: "fake-doc"
+  version: "1.0"
+}
+
+@execute {
+  module: "fake.module.v1"
+  input_ref: "ctx"
+  output_ref: "out.fake"
+}
+```
+
+@manifest {
+  id: "real-doc"
+  version: "1.0"
+}
+
+@context {
+  objective: "Use only live directives outside fences"
+}
+
+@execute {
+  module: "real.module.v1"
+  input_ref: "ctx"
+  output_ref: "out.real"
+}

package/fixtures/malformed-payload.aionis.md

@@ -0,0 +1,9 @@
+@manifest {
+  id: "broken-001"
+  version: "1.0"
+}
+
+@execute {
+  module: "broken.module.v1"
+  input_ref: "ctx"
+  output_ref: "out.broken"

package/fixtures/npm-installed-module-registry.json

@@ -0,0 +1,17 @@
+{
+  "version": "aionis_manifest_npm_module_registry_v1",
+  "modules": [
+    {
+      "module": "research.claims.v1",
+      "package": "@aionis/manifest-module-research-claims"
+    },
+    {
+      "module": "copy.summary.v1",
+      "package": "@aionis/manifest-module-copy-summary"
+    },
+    {
+      "module": "json.transform.v1",
+      "package": "@aionis/manifest-module-json-transform"
+    }
+  ]
+}

package/fixtures/standalone-module-registry.json

@@ -0,0 +1,13 @@
+{
+  "version": "aionis_manifest_module_registry_v1",
+  "modules": [
+    {
+      "module": "research.claims.v1",
+      "entry": "./modules/research-claims.mjs"
+    },
+    {
+      "module": "copy.summary.v1",
+      "entry": "./modules/copy-summary.mjs"
+    }
+  ]
+}

package/fixtures/standalone-runner-plan.json

@@ -0,0 +1,51 @@
+{
+  "plan_version": "execution_plan_v1",
+  "doc": {
+    "id": "standalone-runner-001",
+    "version": "1.0",
+    "kind": "workflow"
+  },
+  "context": {
+    "merged": {
+      "product": "AionisManifest",
+      "objective": "Explain standalone execution"
+    },
+    "frames": [
+      {
+        "product": "AionisManifest",
+        "objective": "Explain standalone execution"
+      }
+    ]
+  },
+  "executions": [
+    {
+      "execution_id": "run.claims",
+      "module": "research.claims.v1",
+      "input_ref": "ctx",
+      "output_ref": "run.claims",
+      "depends_on": []
+    },
+    {
+      "execution_id": "out.summary",
+      "module": "copy.summary.v1",
+      "input_ref": "run.claims",
+      "output_ref": "out.summary",
+      "depends_on": [
+        "run.claims"
+      ]
+    }
+  ],
+  "graph": null,
+  "expected_outputs": [
+    "out.summary"
+  ],
+  "required_capabilities": [
+    "direct_execution"
+  ],
+  "determinism": {
+    "executable": true,
+    "replay_mode": "deterministic",
+    "requires_resume_support": false
+  },
+  "diagnostics": []
+}

package/fixtures/standalone-runner.aionis.md

@@ -0,0 +1,29 @@
+@manifest {
+  id: "standalone-runner-001"
+  version: "1.0"
+  kind: "workflow"
+}
+
+@context {
+  product: "AionisManifest"
+  objective: "Explain standalone execution"
+}
+
+@execute {
+  module: "research.claims.v1"
+  input_ref: "ctx"
+  output_ref: "run.claims"
+}
+
+@execute {
+  module: "copy.summary.v1"
+  input_ref: "run.claims"
+  output_ref: "out.summary"
+  depends_on: ["run.claims"]
+}
+
+@replay {
+  executable: true
+  mode: "deterministic"
+  expected_outputs: ["out.summary"]
+}

package/fixtures/unresolved-ref.aionis.md

@@ -0,0 +1,14 @@
+@manifest {
+  id: "unresolved-001"
+  version: "1.0"
+}
+
+@context {
+  objective: "Known field"
+}
+
+@execute {
+  module: "demo.lookup.v1"
+  input_ref: "ctx.missing"
+  output_ref: "out.result"
+}

package/fixtures/valid-minimal.aionis.md

@@ -0,0 +1,24 @@
+@manifest {
+  id: "demo-001"
+  version: "1.0"
+  kind: "task"
+}
+
+# Goal
+Compile a minimal Aionis manifest.
+
+@context {
+  objective: "Say hello"
+}
+
+@execute {
+  module: "demo.hello.v1"
+  input_ref: "ctx"
+  output_ref: "out.message"
+}
+
+@replay {
+  executable: true
+  mode: "assisted"
+  expected_outputs: ["out.message"]
+}

package/fixtures/valid-workflow.aionis.md

@@ -0,0 +1,29 @@
+@manifest {
+  id: "workflow-001"
+  version: "1.0"
+  kind: "workflow"
+}
+
+@context {
+  product: "EVA"
+  audience: ["founders", "operators"]
+}
+
+@execute {
+  module: "research.claims.v1"
+  input_ref: "ctx"
+  output_ref: "run.claims"
+}
+
+@execute {
+  module: "copy.hero.v1"
+  input_ref: "run.claims"
+  output_ref: "out.hero"
+  depends_on: ["run.claims"]
+}
+
+@replay {
+  executable: true
+  mode: "deterministic"
+  expected_outputs: ["out.hero"]
+}

package/official-modules/copy-summary/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [0.1.0] - 2026-03-18
+
+- First public release of `@aionis/manifest-module-copy-summary`.
+- Exposes `copy.summary.v1` as an official deterministic  AionisManifest module package.

package/official-modules/copy-summary/README.md

@@ -0,0 +1,43 @@
+# @aionis/manifest-module-copy-summary
+
+Official  AionisManifest module that joins a list of claims into a single summary string.
+
+## Install
+
+```bash
+npm i @aionis/manifest-module-copy-summary@0.1.0
+```
+
+## Input
+
+```json
+{
+  "claims": ["Aionis", "turns docs into workflows."]
+}
+```
+
+## Output
+
+```json
+{
+  "summary": "Aionis turns docs into workflows."
+}
+```
+
+## Exports
+
+1. `manifest`
+2. `handler`
+
+## Module ID
+
+`copy.summary.v1`
+
+## Registry Entry
+
+```json
+{
+  "module": "copy.summary.v1",
+  "package": "@aionis/manifest-module-copy-summary"
+}
+```

package/official-modules/copy-summary/index.mjs

@@ -0,0 +1,41 @@
+export const manifest = {
+  module: "copy.summary.v1",
+  version: "1.0.0",
+  title: "Copy Summary",
+  description: "Join an ordered list of claims into one summary string.",
+  deterministic: true,
+  required_capabilities: ["direct_execution"],
+  input_contract: {
+    kind: "object",
+    properties: {
+      claims: {
+        kind: "array",
+        items: { kind: "string" }
+      }
+    },
+    required: ["claims"],
+    additional_properties: false
+  },
+  output_contract: {
+    kind: "object",
+    properties: {
+      summary: { kind: "string" }
+    },
+    required: ["summary"],
+    additional_properties: false
+  }
+};
+
+export async function handler(input) {
+  const claims =
+    input && typeof input === "object" && Array.isArray(input.claims)
+      ? input.claims.filter((item) => typeof item === "string")
+      : [];
+
+  return {
+    kind: "module_result",
+    output: {
+      summary: claims.join(" ")
+    }
+  };
+}

package/official-modules/copy-summary/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aionis/manifest-module-copy-summary",
+  "version": "0.1.0",
+  "description": "Official AionisManifest module for joining claim arrays into a summary string.",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "aionis-manifest",
+    "module",
+    "summary"
+  ],
+  "author": "Aionis Core",
+  "license": "Apache-2.0",
+  "scripts": {
+    "pack:dry-run": "npm pack --dry-run --cache /tmp/aionis-npm-cache"
+  }
+}

package/official-modules/json-transform/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [0.1.0] - 2026-03-18
+
+- First public release of `@aionis/manifest-module-json-transform`.
+- Exposes `json.transform.v1` as an official deterministic  AionisManifest module package.

package/official-modules/json-transform/README.md

@@ -0,0 +1,51 @@
+# @aionis/manifest-module-json-transform
+
+Official  AionisManifest module that deterministically selects a subset of keys from an input object.
+
+## Install
+
+```bash
+npm i @aionis/manifest-module-json-transform@0.1.0
+```
+
+## Input
+
+```json
+{
+  "value": {
+    "product": "Aionis",
+    "mode": "standalone",
+    "ignored": true
+  },
+  "pick": ["mode", "product"]
+}
+```
+
+## Output
+
+```json
+{
+  "result": {
+    "mode": "standalone",
+    "product": "Aionis"
+  }
+}
+```
+
+## Exports
+
+1. `manifest`
+2. `handler`
+
+## Module ID
+
+`json.transform.v1`
+
+## Registry Entry
+
+```json
+{
+  "module": "json.transform.v1",
+  "package": "@aionis/manifest-module-json-transform"
+}
+```

package/official-modules/json-transform/index.mjs

@@ -0,0 +1,53 @@
+export const manifest = {
+  module: "json.transform.v1",
+  version: "1.0.0",
+  title: "JSON Transform",
+  description: "Select a stable subset of object keys from an input record.",
+  deterministic: true,
+  required_capabilities: ["direct_execution"],
+  input_contract: {
+    kind: "object",
+    properties: {
+      value: {
+        kind: "object",
+        additional_properties: true
+      },
+      pick: {
+        kind: "array",
+        items: { kind: "string" }
+      }
+    },
+    required: ["value", "pick"],
+    additional_properties: false
+  },
+  output_contract: {
+    kind: "object",
+    properties: {
+      result: {
+        kind: "object",
+        additional_properties: true
+      }
+    },
+    required: ["result"],
+    additional_properties: false
+  }
+};
+
+export async function handler(input) {
+  const source = input && typeof input === "object" && input.value && typeof input.value === "object" ? input.value : {};
+  const pick = input && typeof input === "object" && Array.isArray(input.pick) ? input.pick : [];
+  const result = {};
+
+  for (const key of pick) {
+    if (typeof key === "string" && Object.prototype.hasOwnProperty.call(source, key)) {
+      result[key] = source[key];
+    }
+  }
+
+  return {
+    kind: "module_result",
+    output: {
+      result
+    }
+  };
+}

package/official-modules/json-transform/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@aionis/manifest-module-json-transform",
+  "version": "0.1.0",
+  "description": "Official AionisManifest module for deterministic object key selection.",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": {
+    ".": "./index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "aionis-manifest",
+    "module",
+    "json"
+  ],
+  "author": "Aionis Core",
+  "license": "Apache-2.0",
+  "scripts": {
+    "pack:dry-run": "npm pack --dry-run --cache /tmp/aionis-npm-cache"
+  }
+}

package/official-modules/research-claims/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## [0.1.0] - 2026-03-18
+
+- First public release of `@aionis/manifest-module-research-claims`.
+- Exposes `research.claims.v1` as an official deterministic  AionisManifest module package.