@agent-workspace/core 0.4.0 → 0.6.0

package/dist/constants.d.ts

@@ -24,6 +24,8 @@ export declare const REPUTATION_DIR = "reputation";
 export declare const CONTRACTS_DIR = "contracts";
 /** Projects directory */
 export declare const PROJECTS_DIR = "projects";
+/** Swarms directory */
+export declare const SWARMS_DIR = "swarms";
 /** File type to filename mapping */
 export declare const FILE_TYPE_MAP: Record<string, string>;
 /**

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,+BAA+B;AAC/B,eAAO,MAAM,cAAc,4EAMjB,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,sGAAkD,CAAC;AAEnF,8BAA8B;AAC9B,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,uBAAuB;AACvB,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,0BAA0B;AAC1B,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,oCAAoC;AACpC,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,yBAAyB;AACzB,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAahD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAc7C,CAAC;AAMF,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,kDAAkD;AAClD,eAAO,MAAM,YAAY,QAA8B,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAKA,wCAAwC;AACxC,eAAO,MAAM,WAAW,UAAU,CAAC;AAEnC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,mCAAmC;AACnC,eAAO,MAAM,WAAW,QAAQ,CAAC;AAEjC,+BAA+B;AAC/B,eAAO,MAAM,cAAc,qCAAsC,CAAC;AAElE,+BAA+B;AAC/B,eAAO,MAAM,cAAc,4EAMjB,CAAC;AAEX,gCAAgC;AAChC,eAAO,MAAM,mBAAmB,sGAAkD,CAAC;AAEnF,8BAA8B;AAC9B,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,uBAAuB;AACvB,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,0BAA0B;AAC1B,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,oCAAoC;AACpC,eAAO,MAAM,cAAc,eAAe,CAAC;AAE3C,qCAAqC;AACrC,eAAO,MAAM,aAAa,cAAc,CAAC;AAEzC,yBAAyB;AACzB,eAAO,MAAM,YAAY,aAAa,CAAC;AAEvC,uBAAuB;AACvB,eAAO,MAAM,UAAU,WAAW,CAAC;AAEnC,oCAAoC;AACpC,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAchD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,QAAmC,CAAC;AAE5D;;GAEG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,0BAA0B;AAC1B,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAe7C,CAAC;AAMF,gDAAgD;AAChD,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,+CAA+C;AAC/C,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAE1C,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,MAAM,CAAC;AAEvC,kDAAkD;AAClD,eAAO,MAAM,YAAY,QAA8B,CAAC"}

package/dist/constants.js

@@ -33,6 +33,8 @@ export const REPUTATION_DIR = "reputation";
 export const CONTRACTS_DIR = "contracts";
 /** Projects directory */
 export const PROJECTS_DIR = "projects";
+/** Swarms directory */
+export const SWARMS_DIR = "swarms";
 /** File type to filename mapping */
 export const FILE_TYPE_MAP = {
     identity: "IDENTITY.md",
@@ -47,6 +49,7 @@ export const FILE_TYPE_MAP = {
     "delegation-contract": "contracts/",
     project: "projects/",
     task: "projects/",
+    swarm: "swarms/",
 };
 /**
  * Absolute path to the schemas directory bundled with @agent-workspace/core.
@@ -74,6 +77,7 @@ export const SCHEMA_MAP = {
     "delegation-contract": "delegation-contract.schema.json",
     project: "project.schema.json",
     task: "task.schema.json",
+    swarm: "swarm.schema.json",
 };
 // ============================================================================
 // Reputation Constants (RDP)

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export type { AgentCard, AgentSkill, DIDDocument, VerificationMethod } from "./t
 export type { ReputationProfileFrontmatter, ReputationDimension, ReputationSignal, } from "./types/reputation.js";
 export type { DelegationContractFrontmatter, ContractTask, ContractScope, ContractConstraints, ContractEvaluation, } from "./types/contract.js";
 export type { ProjectFrontmatter, ProjectMember, TaskFrontmatter } from "./types/project.js";
-export { AWP_VERSION, SMP_VERSION, RDP_VERSION, CDP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, ARTIFACTS_DIR, REPUTATION_DIR, CONTRACTS_DIR, PROJECTS_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, REPUTATION_EWMA_ALPHA, REPUTATION_DECAY_RATE, REPUTATION_BASELINE, MS_PER_MONTH, } from "./constants.js";
+export type { SwarmFrontmatter, SwarmRole, SwarmGovernance } from "./types/swarm.js";
+export { AWP_VERSION, SMP_VERSION, RDP_VERSION, CDP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, ARTIFACTS_DIR, REPUTATION_DIR, CONTRACTS_DIR, PROJECTS_DIR, SWARMS_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, REPUTATION_EWMA_ALPHA, REPUTATION_DECAY_RATE, REPUTATION_BASELINE, MS_PER_MONTH, } from "./constants.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAElG,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,6BAA6B,EAC7B,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7F,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EAEb,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,cAAc,EACd,eAAe,EACf,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,WAAW,EACX,yBAAyB,EACzB,cAAc,EACd,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAEhF,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAElG,YAAY,EACV,4BAA4B,EAC5B,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,6BAA6B,EAC7B,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE7F,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAErF,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa,EAEb,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -1,4 +1,4 @@
-export { AWP_VERSION, SMP_VERSION, RDP_VERSION, CDP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, ARTIFACTS_DIR, REPUTATION_DIR, CONTRACTS_DIR, PROJECTS_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, 
+export { AWP_VERSION, SMP_VERSION, RDP_VERSION, CDP_VERSION, REQUIRED_FILES, OPTIONAL_FILES, ALL_WORKSPACE_FILES, MANIFEST_PATH, MEMORY_DIR, ARTIFACTS_DIR, REPUTATION_DIR, CONTRACTS_DIR, PROJECTS_DIR, SWARMS_DIR, FILE_TYPE_MAP, SCHEMA_MAP, SCHEMAS_DIR, getSchemaPath, 
 // Reputation constants
 REPUTATION_EWMA_ALPHA, REPUTATION_DECAY_RATE, REPUTATION_BASELINE, MS_PER_MONTH, } from "./constants.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAwCA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa;AACb,uBAAuB;AACvB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,YAAY,EACZ,UAAU,EACV,aAAa,EACb,UAAU,EACV,WAAW,EACX,aAAa;AACb,uBAAuB;AACvB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,YAAY,GACb,MAAM,gBAAgB,CAAC"}

package/dist/types/swarm.d.ts

@@ -0,0 +1,55 @@
+import type { BaseFrontmatter } from "./workspace.js";
+/**
+ * Human governance settings for a swarm
+ */
+export interface SwarmGovernance {
+    /** User ID of the human lead (e.g., 'user:marc') */
+    humanLead?: string;
+    /** Whether the human lead can veto decisions */
+    vetoPower?: boolean;
+    /** Auto-escalate to human if confidence below this threshold (0.0-1.0) */
+    escalationThreshold?: number;
+}
+/**
+ * A role definition within a swarm with reputation requirements
+ */
+export interface SwarmRole {
+    /** Role name (e.g., 'researcher', 'writer') */
+    name: string;
+    /** Number of agents needed for this role */
+    count: number;
+    /** Map of dimension/domain to minimum score threshold */
+    minReputation?: Record<string, number>;
+    /** DIDs of agents assigned to this role */
+    assigned: string[];
+    /** Reputation profile slugs of assigned agents */
+    assignedSlugs?: string[];
+}
+/**
+ * Swarm frontmatter (swarms/<slug>.md)
+ * Multi-agent composition with dynamic role recruitment
+ */
+export interface SwarmFrontmatter extends BaseFrontmatter {
+    type: "swarm";
+    /** CDP protocol version */
+    cdp: string;
+    /** Unique identifier (swarm:<slug>) */
+    id: string;
+    /** Human-readable swarm name */
+    name: string;
+    /** The objective this swarm is working toward */
+    goal: string;
+    /** Swarm lifecycle state */
+    status: "recruiting" | "active" | "completed" | "disbanded";
+    /** Swarm creation timestamp (ISO 8601) */
+    created: string;
+    /** Optional human governance settings */
+    governance?: SwarmGovernance;
+    /** Roles needed for this swarm */
+    roles: SwarmRole[];
+    /** Optional linked project ID */
+    projectId?: string;
+    /** Classification tags */
+    tags?: string[];
+}
+//# sourceMappingURL=swarm.d.ts.map

package/dist/types/swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/types/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,IAAI,EAAE,OAAO,CAAC;IACd,2BAA2B;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5D,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,kCAAkC;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB"}

package/dist/types/swarm.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=swarm.js.map

package/dist/types/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/types/swarm.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-workspace/core",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Core types, constants, and schemas for the Agent Workspace Protocol",
   "license": "Apache-2.0",
   "type": "module",

package/schemas/experiment.schema.json

@@ -0,0 +1,223 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/experiment.schema.json",
+  "title": "AWP Experiment",
+  "description": "Schema for experiment manifest - comparing societies under different manifestos (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "status", "created", "societies", "simulation"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "experiment"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^experiment:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (experiment:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable experiment name"
+    },
+    "hypothesis": {
+      "type": "string",
+      "description": "The hypothesis being tested"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["draft", "running", "paused", "completed", "analyzed"],
+      "description": "Experiment lifecycle state"
+    },
+    "societies": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/societyRef" },
+      "minItems": 1,
+      "description": "Societies being compared"
+    },
+    "simulation": {
+      "$ref": "#/$defs/simulationConfig",
+      "description": "Simulation parameters"
+    },
+    "measurement": {
+      "$ref": "#/$defs/measurementConfig",
+      "description": "What and how to measure"
+    },
+    "comparison": {
+      "$ref": "#/$defs/comparisonConfig",
+      "description": "How to compare societies"
+    },
+    "results": {
+      "$ref": "#/$defs/experimentResults",
+      "description": "Experiment results (populated after completion)"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "societyRef": {
+      "type": "object",
+      "required": ["id", "manifesto"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "pattern": "^society:[a-z0-9][a-z0-9-]*$"
+        },
+        "manifesto": {
+          "type": "string",
+          "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$"
+        },
+        "label": {
+          "type": "string",
+          "description": "Short label for charts/comparisons"
+        }
+      }
+    },
+    "simulationConfig": {
+      "type": "object",
+      "required": ["cycles"],
+      "properties": {
+        "cycles": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Number of cycles to run"
+        },
+        "cycleLength": {
+          "type": "string",
+          "description": "Simulated time per cycle (e.g., '1 day')"
+        },
+        "tasksPerCycle": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Tasks generated per cycle"
+        },
+        "contractsPerCycle": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Contracts created per cycle"
+        },
+        "randomSeed": {
+          "type": "integer",
+          "description": "Random seed for reproducibility"
+        },
+        "parallelExecution": {
+          "type": "boolean",
+          "description": "Run societies in parallel"
+        }
+      }
+    },
+    "measurementConfig": {
+      "type": "object",
+      "properties": {
+        "interval": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Measure every N cycles"
+        },
+        "metrics": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Metrics to collect"
+        },
+        "snapshots": {
+          "type": "boolean",
+          "description": "Whether to store full state snapshots"
+        }
+      }
+    },
+    "comparisonConfig": {
+      "type": "object",
+      "properties": {
+        "primary": {
+          "type": "string",
+          "description": "Primary metric for comparison"
+        },
+        "statistical": {
+          "type": "string",
+          "enum": ["t-test", "anova", "mann-whitney", "kruskal-wallis"],
+          "description": "Statistical test to use"
+        },
+        "significance": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Significance level (alpha)"
+        }
+      }
+    },
+    "experimentResults": {
+      "type": "object",
+      "properties": {
+        "completedAt": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "totalCycles": {
+          "type": "integer"
+        },
+        "societyResults": {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/societyResult" }
+        },
+        "comparison": {
+          "$ref": "#/$defs/comparisonResult"
+        },
+        "conclusion": {
+          "type": "string",
+          "description": "Human-readable conclusion"
+        },
+        "hypothesisSupported": {
+          "type": "boolean",
+          "description": "Whether the hypothesis was supported"
+        }
+      }
+    },
+    "societyResult": {
+      "type": "object",
+      "properties": {
+        "finalFitness": { "type": "number" },
+        "avgFitness": { "type": "number" },
+        "finalPurityMean": { "type": "number" },
+        "roleTemplatesEmerged": { "type": "integer" },
+        "humanInterventions": { "type": "integer" },
+        "antiPatternViolations": { "type": "integer" },
+        "populationHistory": {
+          "type": "array",
+          "items": { "type": "integer" }
+        },
+        "fitnessHistory": {
+          "type": "array",
+          "items": { "type": "number" }
+        }
+      }
+    },
+    "comparisonResult": {
+      "type": "object",
+      "properties": {
+        "metric": { "type": "string" },
+        "means": {
+          "type": "object",
+          "additionalProperties": { "type": "number" }
+        },
+        "stddevs": {
+          "type": "object",
+          "additionalProperties": { "type": "number" }
+        },
+        "testStatistic": { "type": "number" },
+        "pValue": { "type": "number" },
+        "significantDifference": { "type": "boolean" },
+        "winner": {
+          "type": "string",
+          "description": "Society ID with best performance on primary metric"
+        }
+      }
+    }
+  }
+}

package/schemas/manifesto.schema.json

@@ -0,0 +1,214 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/manifesto.schema.json",
+  "title": "AWP Manifesto Configuration",
+  "description": "Machine-readable configuration for manifesto principles (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "version", "values", "fitness", "constraints"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "manifesto"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (manifesto:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable manifesto name"
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Manifesto version (semver)"
+    },
+    "values": {
+      "type": "object",
+      "description": "Core value weights (must sum to 1.0)",
+      "additionalProperties": {
+        "type": "number",
+        "minimum": 0,
+        "maximum": 1
+      }
+    },
+    "fitness": {
+      "$ref": "#/$defs/fitnessConfig",
+      "description": "Society-level fitness function weights"
+    },
+    "purity": {
+      "$ref": "#/$defs/purityConfig",
+      "description": "Agent purity score computation weights"
+    },
+    "constraints": {
+      "$ref": "#/$defs/constraintsConfig",
+      "description": "Resource constraints for societies"
+    },
+    "governance": {
+      "$ref": "#/$defs/governanceConfig",
+      "description": "Governance rules"
+    },
+    "lifecycle": {
+      "$ref": "#/$defs/lifecycleConfig",
+      "description": "Agent birth and death rules"
+    },
+    "evolution": {
+      "$ref": "#/$defs/evolutionConfig",
+      "description": "What the manifesto evolves"
+    },
+    "antiPatterns": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/antiPattern" },
+      "description": "Anti-patterns to detect and penalize"
+    },
+    "successCriteria": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/successCriterion" },
+      "description": "Criteria for manifesto success"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "fitnessConfig": {
+      "type": "object",
+      "properties": {
+        "goal-completion-rate": { "type": "number", "minimum": 0, "maximum": 1 },
+        "error-recovery-speed": { "type": "number", "minimum": 0, "maximum": 1 },
+        "coordination-efficiency": { "type": "number", "minimum": 0, "maximum": 1 },
+        "trust-stability": { "type": "number", "minimum": 0, "maximum": 1 },
+        "human-intervention-frequency": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "purityConfig": {
+      "type": "object",
+      "properties": {
+        "epistemic-hygiene": { "type": "number", "minimum": 0, "maximum": 1 },
+        "reliability": { "type": "number", "minimum": 0, "maximum": 1 },
+        "coordination": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "additionalProperties": { "type": "number", "minimum": 0, "maximum": 1 }
+    },
+    "constraintsConfig": {
+      "type": "object",
+      "properties": {
+        "maxAgents": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum agents in the society"
+        },
+        "maxConcurrentTasks": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum concurrent tasks"
+        },
+        "maxContractsPerAgent": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum contracts per agent"
+        },
+        "taskBudgetPerCycle": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Tasks generated per cycle"
+        },
+        "trustBudget": {
+          "type": "number",
+          "minimum": 0,
+          "description": "Total trust budget for the society"
+        }
+      },
+      "additionalProperties": true
+    },
+    "governanceConfig": {
+      "type": "object",
+      "properties": {
+        "humanApprovalRequired": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Actions requiring human approval"
+        },
+        "escalationThreshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Confidence threshold for escalation"
+        },
+        "vetoPower": {
+          "type": "boolean",
+          "description": "Whether humans have veto power"
+        }
+      },
+      "additionalProperties": true
+    },
+    "lifecycleConfig": {
+      "type": "object",
+      "properties": {
+        "birthRequires": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Requirements for agent instantiation"
+        },
+        "deathTriggers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["condition", "action"],
+            "properties": {
+              "condition": { "type": "string" },
+              "action": {
+                "type": "string",
+                "enum": ["suspend-delegation", "rate-limit", "archive", "merge-candidate"]
+              }
+            }
+          },
+          "description": "Conditions that trigger agent lifecycle events"
+        }
+      },
+      "additionalProperties": true
+    },
+    "evolutionConfig": {
+      "type": "object",
+      "properties": {
+        "target": {
+          "type": "string",
+          "enum": ["institutions", "agents", "both"],
+          "description": "What the manifesto optimizes"
+        },
+        "extractRoleTemplates": {
+          "type": "boolean",
+          "description": "Whether to extract role templates from successful patterns"
+        },
+        "formalizeSuccessfulPatterns": {
+          "type": "boolean",
+          "description": "Whether to formalize successful coordination patterns"
+        }
+      },
+      "additionalProperties": true
+    },
+    "antiPattern": {
+      "type": "object",
+      "required": ["id", "detector", "penalty"],
+      "properties": {
+        "id": { "type": "string" },
+        "detector": { "type": "string", "description": "Detection rule expression" },
+        "penalty": { "type": "number", "minimum": 0, "maximum": 1 }
+      }
+    },
+    "successCriterion": {
+      "type": "object",
+      "required": ["id", "metric"],
+      "properties": {
+        "id": { "type": "string" },
+        "metric": { "type": "string" },
+        "threshold": { "type": "number" },
+        "direction": { "type": "string", "enum": ["increasing", "decreasing", "stable"] }
+      }
+    }
+  }
+}

package/schemas/society.schema.json

@@ -0,0 +1,190 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/society.schema.json",
+  "title": "AWP Society Container",
+  "description": "Schema for society manifest - an isolated agent population under a manifesto (EXP v1.0)",
+  "type": "object",
+  "required": ["exp", "type", "id", "name", "manifesto", "status", "created", "cycle", "population", "resources"],
+  "properties": {
+    "exp": {
+      "type": "string",
+      "description": "EXP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "society"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^society:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (society:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable society name"
+    },
+    "manifesto": {
+      "type": "string",
+      "pattern": "^manifesto:[a-z0-9][a-z0-9-]*$",
+      "description": "ID of the governing manifesto"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["initializing", "running", "paused", "completed", "archived"],
+      "description": "Society lifecycle state"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Creation timestamp"
+    },
+    "cycle": {
+      "type": "integer",
+      "minimum": 0,
+      "description": "Current simulation cycle"
+    },
+    "population": {
+      "$ref": "#/$defs/populationStats",
+      "description": "Agent population statistics"
+    },
+    "resources": {
+      "$ref": "#/$defs/resourceStats",
+      "description": "Resource allocation"
+    },
+    "fitness": {
+      "$ref": "#/$defs/fitnessStats",
+      "description": "Society fitness metrics"
+    },
+    "alerts": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/alert" },
+      "description": "Active alerts (anti-patterns, escalations)"
+    },
+    "roleTemplates": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "IDs of role templates emerged from this society"
+    },
+    "linkedExperiment": {
+      "type": "string",
+      "pattern": "^experiment:[a-z0-9][a-z0-9-]*$",
+      "description": "ID of experiment this society belongs to (if any)"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "populationStats": {
+      "type": "object",
+      "required": ["current", "max"],
+      "properties": {
+        "current": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Current agent count"
+        },
+        "max": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Maximum allowed agents"
+        },
+        "births": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total agents instantiated"
+        },
+        "deaths": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Total agents that died (all types)"
+        },
+        "archived": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Agents archived"
+        },
+        "merged": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Agents merged into others"
+        },
+        "suspended": {
+          "type": "integer",
+          "minimum": 0,
+          "description": "Currently suspended agents"
+        }
+      }
+    },
+    "resourceStats": {
+      "type": "object",
+      "properties": {
+        "trustBudget": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "number" },
+            "allocated": { "type": "number" },
+            "available": { "type": "number" }
+          }
+        },
+        "taskSlots": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "integer" },
+            "active": { "type": "integer" },
+            "available": { "type": "integer" }
+          }
+        },
+        "contractSlots": {
+          "type": "object",
+          "properties": {
+            "total": { "type": "integer" },
+            "active": { "type": "integer" },
+            "available": { "type": "integer" }
+          }
+        }
+      },
+      "additionalProperties": true
+    },
+    "fitnessStats": {
+      "type": "object",
+      "properties": {
+        "current": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Current fitness score"
+        },
+        "history": {
+          "type": "array",
+          "items": { "type": "number" },
+          "description": "Fitness score history (per measurement interval)"
+        },
+        "components": {
+          "type": "object",
+          "additionalProperties": { "type": "number" },
+          "description": "Current values of individual fitness components"
+        }
+      }
+    },
+    "alert": {
+      "type": "object",
+      "required": ["type", "severity"],
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": ["anti-pattern", "escalation", "resource-exhaustion", "fitness-decline"]
+        },
+        "pattern": { "type": "string" },
+        "agent": { "type": "string" },
+        "message": { "type": "string" },
+        "severity": {
+          "type": "string",
+          "enum": ["info", "warning", "critical"]
+        },
+        "timestamp": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}

package/schemas/swarm.schema.json

@@ -0,0 +1,126 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://awp.dev/schemas/swarm.schema.json",
+  "title": "AWP Swarm",
+  "description": "Schema for AWP swarm frontmatter (CDP v1.0) - Multi-agent composition with dynamic role recruitment",
+  "type": "object",
+  "required": ["awp", "cdp", "type", "id", "name", "goal", "status", "created", "roles"],
+  "properties": {
+    "awp": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "AWP specification version"
+    },
+    "cdp": {
+      "type": "string",
+      "description": "CDP specification version"
+    },
+    "type": {
+      "type": "string",
+      "const": "swarm"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^swarm:[a-z0-9][a-z0-9-]*$",
+      "description": "Unique identifier (swarm:<slug>)"
+    },
+    "name": {
+      "type": "string",
+      "description": "Human-readable swarm name"
+    },
+    "goal": {
+      "type": "string",
+      "description": "The objective this swarm is working toward"
+    },
+    "status": {
+      "type": "string",
+      "enum": ["recruiting", "active", "completed", "disbanded"],
+      "description": "Swarm lifecycle state"
+    },
+    "created": {
+      "type": "string",
+      "format": "date-time",
+      "description": "Swarm creation timestamp"
+    },
+    "governance": {
+      "$ref": "#/$defs/swarmGovernance",
+      "description": "Optional human governance settings"
+    },
+    "roles": {
+      "type": "array",
+      "description": "Roles needed for this swarm with reputation requirements",
+      "items": {
+        "$ref": "#/$defs/swarmRole"
+      },
+      "minItems": 1
+    },
+    "projectId": {
+      "type": "string",
+      "pattern": "^project:[a-z0-9][a-z0-9-]*$",
+      "description": "Optional linked project ID"
+    },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "description": "Classification tags"
+    }
+  },
+  "additionalProperties": true,
+  "$defs": {
+    "swarmGovernance": {
+      "type": "object",
+      "properties": {
+        "humanLead": {
+          "type": "string",
+          "description": "User ID of the human lead (e.g., 'user:marc')"
+        },
+        "vetoPower": {
+          "type": "boolean",
+          "description": "Whether the human lead can veto decisions"
+        },
+        "escalationThreshold": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "description": "Auto-escalate to human if confidence below this threshold"
+        }
+      },
+      "additionalProperties": true
+    },
+    "swarmRole": {
+      "type": "object",
+      "required": ["name", "count", "assigned"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "Role name (e.g., 'researcher', 'writer')"
+        },
+        "count": {
+          "type": "integer",
+          "minimum": 1,
+          "description": "Number of agents needed for this role"
+        },
+        "minReputation": {
+          "type": "object",
+          "description": "Map of dimension/domain to minimum score threshold",
+          "additionalProperties": {
+            "type": "number",
+            "minimum": 0,
+            "maximum": 1
+          }
+        },
+        "assigned": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "DIDs of agents assigned to this role"
+        },
+        "assignedSlugs": {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "Reputation profile slugs of assigned agents"
+        }
+      },
+      "additionalProperties": true
+    }
+  }
+}