{"_id":"@bjornkennethholmstrom/ggf-core","_rev":"7-1f042cacfb6d68d7596781f9c7061612","name":"@bjornkennethholmstrom/ggf-core","dist-tags":{"latest":"0.1.6"},"versions":{"0.1.0":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.0","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.0","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"decc8589dd9207499eda1ae641008d72e09eb5d6","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.0.tgz","fileCount":12,"integrity":"sha512-3xy61AFpbngeFnMUfdw+ArNcAFhEQGwtuhZuH4vn5u/y5O/RkjjQnR7hJzjE7wHCH8k10cIomcMY8WmWhsjCKg==","signatures":[{"sig":"MEUCIQDFTcg2r+lA+WNr7xnhAUqz3yevggpmOUmfue2vJYOq8QIgQk/DTQbKPY3SmNG2g5qZ2FUg6pofFZlhlLNp62ORcdw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51610},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"5625411d497fe7e38412d97736dce2f5c9d1e3c3","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.0_1753570342078_0.0013653674295610596","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.1","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.1","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"59fc38d32910c9f0a381166f47f5c8c372d2044d","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.1.tgz","fileCount":12,"integrity":"sha512-gcuyG0Q+Bmg9oup+pMqc9/YBlw2H/VSQ5NNTuqAYYeCxF66y2OxxhQEY1F2FWMZ/3deF4ziYbiJt8gsAPS0C1g==","signatures":[{"sig":"MEYCIQCsPiHIhuaOcSoGZhMtga1iJUDMxTxfgMhNoYIKOlENJQIhAK8++++QE8OS2Vzsnj4/dSTyG+xonMlo9JuTzTIK4wCk","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":51682},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"5625411d497fe7e38412d97736dce2f5c9d1e3c3","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.1_1753570474237_0.6859825737024239","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.2","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.2","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"58604e9893645173be0ac1c7c1e913ddf99d4bae","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.2.tgz","fileCount":13,"integrity":"sha512-mdeedR06HSuLjxbIAgTz9hcEKvDdUoou9J8NOxEI2qmCvxMkEiSE9JUuCPSEP0ZeiBEIpbmvIUzNAe5qzAJm1Q==","signatures":[{"sig":"MEQCIA6Itq/DaHZx1Q2kLSka52oedw4kbXMGJlu11zM8ymw9AiBjBdm/ikNO0O6nHogagWmHiL/Ig7krx+8zlqu9IfQOOw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52815},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"8c67fdd671ee6b6f5af69019adbe5872567bf2db","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.2_1753572402460_0.3501766910470665","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.3","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.3","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"0147ffdd8f259f64bea0370e2d57e68dbe2c3a2f","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.3.tgz","fileCount":13,"integrity":"sha512-75mJ7+8ux/C8NPi0s0eR/ItVcaPPovhD3oor3mDhtTWeLQeX/0r0l4Q5CZ8l40Sc5ZsvD+2ZiKZlepZNIcinfg==","signatures":[{"sig":"MEUCIEmXFJOgz4fsORtHXTao/h7MW1vHsXLGeuIRzc/DqogqAiEAliVs+EJ8dCmmaJ8W+WMNddcNKqydRUvgLuZOL5UaP3M=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":53211},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"169d496943bacff5fa314062c331c7f6f414ee37","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.3_1753573030854_0.6813304213795295","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.4","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.4","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"c11d043c03b0ac7ef101dfe55e2f6493f679a6c9","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.4.tgz","fileCount":15,"integrity":"sha512-QcJNu1RD3QTONI0V8HlUvidwCVjMf04vEljQBxSIvERhOKmJgBieCGFAG7V3WdizKlP1xip6JnYSO02eD406nw==","signatures":[{"sig":"MEQCIHsfQK2SGJQ4xx8vvVgzNTCQ5RjCHhtNIOmVav4irXDGAiAOkDsArxmgc23oqRMtX+bBPsbwIyk/MpteeIGIUhzaBg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":54564},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"27b9e8fa3e21e6f24ace396b75a1e22b2ecb2c32","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.4_1753573580215_0.13276032043418362","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.5","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","_id":"@bjornkennethholmstrom/ggf-core@0.1.5","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"homepage":"https://globalgovernanceframeworks.org","bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"dist":{"shasum":"91dd9fc513ab66613485fa832210fc88425d9171","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.5.tgz","fileCount":16,"integrity":"sha512-zz56b4bW7vqFwzVwwJ4WNLanZu0z6zZKDlPE5Aq+giW4533HXdqBFr3OMM4csMzk6GjWT/SzfS7/ZxGUfCp3YA==","signatures":[{"sig":"MEQCIF90EGKclJ2xfWY3cmzWHdHs0TuOgsSOiF3a5zsbhZkFAiBCkfgslGsX9k0dcwIopP0snMo0ghASjqbwXZjLMx6UGQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":65590},"main":"index.js","type":"module","exports":{".":"./index.js","./examples/*":"./examples/*","./packages/*":"./packages/*","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*"},"gitHead":"9a9b8049ba05a028c2854d76c679d3efbdc7f36e","scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"repository":{"url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git","type":"git"},"_npmVersion":"11.4.2","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","directories":{"example":"examples"},"_nodeVersion":"22.13.0","dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/ggf-core_0.1.5_1753575562520_0.294557475496787","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@bjornkennethholmstrom/ggf-core","version":"0.1.6","description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","main":"index.js","type":"module","directories":{"example":"examples"},"exports":{".":"./index.js","./schemas/egp/*":"./schemas/egp/*","./schemas/unified/*":"./schemas/unified/*","./schemas/love-ledger/*":"./schemas/love-ledger/*","./examples/*":"./examples/*","./packages/*":"./packages/*"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"author":{"name":"Global Governance Frameworks"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git"},"bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"homepage":"https://globalgovernanceframeworks.org","publishConfig":{"access":"public"},"dependencies":{"ajv":"^8.17.1","ajv-formats":"^3.0.1"},"_id":"@bjornkennethholmstrom/ggf-core@0.1.6","gitHead":"0c5fac0f7ef96f84ab9bee2f90cda9bafe24fefb","_nodeVersion":"22.13.0","_npmVersion":"11.4.2","dist":{"integrity":"sha512-5EPrpp1xqGQFDM/yWRbESlEfShTLsHfmQ/0zBDpwL4bNnUo2KXC6atgekPrO1XhPeuJrrTWAtfrEqC3tncQZ7g==","shasum":"75ee7b2bf4b37b4da41bea32e4a6806da07d6a9a","tarball":"https://registry.npmjs.org/@bjornkennethholmstrom/ggf-core/-/ggf-core-0.1.6.tgz","fileCount":16,"unpackedSize":65589,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEi5e32oYLlUccZr7P0DiuMx6NEfM7Kg1NSvPPKb+qeUAiBcLOElo+Kk7cHTQwOJbtALBgUKu7w8DrVIBk9lhbvRiQ=="}]},"_npmUser":{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"},"maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ggf-core_0.1.6_1753575843550_0.8020904463306882"},"_hasShrinkwrap":false}},"time":{"created":"2025-07-26T22:52:21.993Z","modified":"2025-07-27T00:24:03.946Z","0.1.0":"2025-07-26T22:52:22.305Z","0.1.1":"2025-07-26T22:54:34.400Z","0.1.2":"2025-07-26T23:26:42.663Z","0.1.3":"2025-07-26T23:37:11.037Z","0.1.4":"2025-07-26T23:46:20.399Z","0.1.5":"2025-07-27T00:19:22.699Z","0.1.6":"2025-07-27T00:24:03.756Z"},"bugs":{"url":"https://github.com/GlobalGovernanceFrameworks/ggf-core/issues"},"author":{"name":"Global Governance Frameworks"},"license":"MIT","homepage":"https://globalgovernanceframeworks.org","keywords":["governance","schemas","egp","love-ledger","aubi","json-schema","care-economy"],"repository":{"type":"git","url":"git+https://github.com/GlobalGovernanceFrameworks/ggf-core.git"},"description":"Welcome to the foundational layer of the Global Governance Frameworks ecosystem, with shared schemas and utilities! 🏗️","maintainers":[{"name":"bjornkennethholmstrom","email":"bjorn.kenneth.holmstrom@gmail.com"}],"readme":"# GGF Core\n## Shared Libraries and Type Definitions\n\nWelcome to the foundational layer of the Global Governance Frameworks ecosystem! 🏗️\n\n## Purpose\n\nGGF Core provides the **shared infrastructure** that enables seamless integration across the Global Governance Frameworks ecosystem. It contains the schemas, types, validators, and utilities that ensure all frameworks can communicate effectively while maintaining their distinct purposes.\n\n## What's Included\n\n### 📋 **Unified Schemas**\n- **EGP Base Schemas**: Core governance operations (`sense`, `propose`, `adopt`)\n- **Love Ledger Extensions**: Care economy metadata (`care_metrics`, `currency_alloc`)\n- **AUBI Integration**: Payment layer specifications (`aubi_integration`)\n- **Cross-Framework Types**: Shared data structures and validation rules\n\n### 🔧 **Developer Tools**\n- **TypeScript Definitions**: Full type safety across all frameworks\n- **JSON Schema Validators**: Runtime validation for all data structures\n- **Conversion Utilities**: Inter-Currency Translation Layer helpers\n- **Testing Fixtures**: Sample data for development and testing\n\n### 🌐 **Integration Layer**\n- **DID Utilities**: Decentralized identifier handling\n- **Blockchain Helpers**: IPFS, content addressing, and verification\n- **Cultural Adapters**: Tools for community-specific customization\n- **Privacy Tools**: Zero-knowledge proof utilities and encryption helpers\n\n## Ecosystem Architecture\n\n```mermaid\ngraph TB\n    subgraph \"GGF Core Foundation\"\n        A[Unified Schemas] --> B[Type Definitions]\n        B --> C[Validators & Utils]\n    end\n    \n    subgraph \"Framework Layer\"\n        D[EGP] --> A\n        E[Love Ledger] --> A\n        F[AUBI Framework] --> A\n    end\n    \n    subgraph \"Implementation Layer\"\n        G[Community Apps] --> D\n        G --> E\n        G --> F\n    end\n```\n\n## Key Components\n\n### 🏛️ **EGP Integration**\n```typescript\n// Base EGP operation with extension points\ninterface EGPOperation {\n  operation: 'sense' | 'propose' | 'adopt';\n  timestamp: string;\n  agent: string;\n  location?: LocationMetadata;\n  content: ContentBlock;\n  extensions?: Record<string, any>; // Love Ledger, AUBI, etc.\n}\n```\n\n### 💚 **Love Ledger Extensions**\n```typescript\n// Care economy metadata that extends EGP operations\ninterface CareMetrics {\n  act_type: 'childcare' | 'elders' | 'ecological' | 'cultural';\n  hours: number;\n  impact_score: 1 | 2 | 3 | 4 | 5;\n  validation?: CommunityValidation;\n}\n\ninterface CurrencyAllocation {\n  hearts?: number;\n  leaves?: LeavesNFT;\n}\n```\n\n### 🌍 **AUBI Integration**\n```typescript\n// Payment layer specifications\ninterface AUBIIntegration {\n  layer: 1 | 2 | 3 | 4;\n  payout_calculation: PayoutFormula;\n  sunset_clause?: string; // ISO 8601 duration\n  cultural_adaptations?: Record<string, any>;\n}\n```\n\n### 🔄 **Inter-Currency Translation**\n```typescript\n// Convert between different value systems\ninterface ConversionRate {\n  from_system: 'time_banks' | 'care_acts' | 'carbon_credits' | 'fiat';\n  to_currency: 'hearts' | 'leaves' | 'fiat';\n  formula: string;\n  multipliers?: Record<string, number>; // Cultural, regional adjustments\n}\n```\n\n## Installation & Usage\n\n### For Framework Developers\n```bash\n# Install GGF Core in your framework\nnpm install @ggf/core\n\n# Import schemas and types\nimport { EGPOperation, validateCareAct } from '@ggf/core';\nimport { unifiedSchema } from '@ggf/core/schemas';\n```\n\n### For Application Developers  \n```bash\n# Use pre-built validation and conversion tools\nimport { \n  validateEGPOperation,\n  convertToHearts,\n  createLeavesNFT \n} from '@ggf/core/utils';\n```\n\n### For Community Implementers\n```bash\n# Access example payloads and integration guides\ngit clone https://github.com/GlobalGovernanceFrameworks/ggf-core\ncd ggf-core/examples\n```\n\n## Schema Evolution\n\n### Version Management\n- **Semantic Versioning**: Schema changes follow semver (major.minor.patch)\n- **Backward Compatibility**: Maintained for at least 2 major versions\n- **Migration Tools**: Automated conversion between schema versions\n- **Community Input**: Schema changes require multi-framework review\n\n### Extension Protocol\n```json\n{\n  \"operation\": \"sense\",\n  \"schema_version\": \"1.2.0\",\n  \"extensions\": {\n    \"love_ledger\": {\n      \"version\": \"0.8.0\",\n      \"care_metrics\": { ... }\n    },\n    \"aubi\": {\n      \"version\": \"1.1.0\", \n      \"layer_calculation\": { ... }\n    }\n  }\n}\n```\n\n## Framework Integration Examples\n\n### 🏛️ **EGP + Love Ledger**\n```json\n{\n  \"operation\": \"propose\",\n  \"timestamp\": \"2025-07-25T15:00:00Z\",\n  \"agent\": \"did:example:weaver\",\n  \"content\": {\n    \"title\": \"Community Elder Care Program\",\n    \"description\": \"Daily check-ins by volunteers\"\n  },\n  \"extensions\": {\n    \"love_ledger\": {\n      \"care_metrics\": {\n        \"act_type\": \"elders\",\n        \"hours\": 2,\n        \"impact_score\": 4\n      },\n      \"currency_alloc\": {\n        \"hearts\": 40\n      }\n    }\n  }\n}\n```\n\n### 💰 **Love Ledger + AUBI**\n```json\n{\n  \"care_contribution\": {\n    \"agent\": \"did:example:maria\",\n    \"acts\": [\n      {\n        \"type\": \"eldercare\",\n        \"hours\": 10,\n        \"validation\": \"community_verified\"\n      }\n    ]\n  },\n  \"aubi_calculation\": {\n    \"base_layer_1\": 1200,\n    \"layer_2_bonus\": {\n      \"hearts_earned\": 200,\n      \"multiplier\": 1.3,\n      \"total_bonus\": 260\n    }\n  }\n}\n```\n\n### 🌱 **Full Ecosystem Integration**\n```json\n{\n  \"operation\": \"adopt\",\n  \"agent\": \"baz:indigenous_council\",\n  \"content\": {\n    \"title\": \"Watershed Restoration Project\"\n  },\n  \"extensions\": {\n    \"love_ledger\": {\n      \"care_metrics\": {\n        \"act_type\": \"ecological\", \n        \"hours\": 40,\n        \"impact_score\": 5\n      },\n      \"currency_alloc\": {\n        \"hearts\": 100,\n        \"leaves\": {\n          \"amount\": 20,\n          \"nft_metadata\": {\n            \"gps\": \"coordinates\",\n            \"eco_act\": \"stream_restoration\"\n          }\n        }\n      }\n    },\n    \"aubi\": {\n      \"layer\": 2,\n      \"green_job_score\": 1.4,\n      \"total_payout\": 380\n    }\n  }\n}\n```\n\n## Developer Resources\n\n### 🧪 **Testing & Validation**\n```javascript\nimport { validateUnifiedSchema } from '@ggf/core/validators';\n\nconst isValid = validateUnifiedSchema({\n  operation: 'sense',\n  timestamp: new Date().toISOString(),\n  agent: 'did:example:user',\n  extensions: {\n    love_ledger: { ... }\n  }\n});\n```\n\n### 🔄 **Currency Conversion**\n```javascript\nimport { convertToHearts, InterCurrencyLayer } from '@ggf/core/converters';\n\nconst heartsEarned = convertToHearts({\n  system: 'care_acts',\n  hours: 5,\n  impact_score: 4,\n  cultural_multiplier: 1.2\n});\n```\n\n### 🏗️ **Schema Extensions**\n```javascript\n// Extend schemas for custom frameworks\nimport { createExtensionSchema } from '@ggf/core/schema-builder';\n\nconst customSchema = createExtensionSchema({\n  namespace: 'my_framework',\n  fields: {\n    custom_metric: 'number',\n    special_validation: 'string'\n  }\n});\n```\n\n## Community Standards\n\n### 📐 **Design Principles**\n- **Interoperability First**: All schemas must support cross-framework communication\n- **Cultural Sensitivity**: Extension points for community-specific adaptations\n- **Privacy Protection**: Built-in support for zero-knowledge proofs and user control\n- **Accessibility**: Multi-modal support (text, audio, visual, tactile)\n- **Versioning**: Clear migration paths and backward compatibility\n\n### 🤝 **Contribution Guidelines**\n- **RFC Process**: Major schema changes require Request for Comments\n- **Multi-Framework Review**: Changes must be approved by EGP, Love Ledger, and AUBI maintainers\n- **Community Input**: Indigenous communities and pilot BAZs have veto power over cultural adaptations\n- **Testing Requirements**: All changes must include comprehensive test suites\n- **Documentation**: Clear examples and migration guides for all changes\n\n### 🛡️ **Security Standards**\n- **Cryptographic Verification**: All schemas support content addressing and verification\n- **Privacy by Design**: Personal data minimization and user-controlled sharing\n- **Cultural Protection**: Traditional knowledge flagging and access control\n- **Fraud Prevention**: Built-in validation and anomaly detection support\n\n## Framework Connections\n\n### 🏛️ **[Emergent Governance Protocol](https://github.com/GlobalGovernanceFrameworks/egp)**\n- **Imports**: Base operation schemas, validation utilities\n- **Provides**: Governance operation structure for other frameworks\n- **Integration**: Extension points for care economy and payment data\n\n### 💚 **[Love Ledger](https://github.com/GlobalGovernanceFrameworks/love-ledger)**\n- **Imports**: EGP schemas, DID utilities, blockchain helpers\n- **Extends**: Care metrics, Hearts/Leaves allocation, community validation\n- **Provides**: Care economy data structures for AUBI integration\n\n### 🌍 **[AUBI Framework](https://github.com/GlobalGovernanceFrameworks/aubi-framework)**\n- **Imports**: EGP schemas, Love Ledger extensions, conversion utilities\n- **Extends**: Payment calculations, layer specifications, LMCI metrics\n- **Provides**: Economic distribution logic for the entire ecosystem\n\n## Implementation Support\n\n### 📚 **Documentation**\n- **Integration Guides**: Step-by-step framework connection instructions\n- **API References**: Complete TypeScript definitions and JSON schemas\n- **Example Payloads**: Real-world data samples for all use cases\n- **Migration Tools**: Version upgrade and conversion utilities\n\n### 🛠️ **Development Tools**\n- **CLI Tools**: Schema validation, conversion testing, example generation\n- **IDE Extensions**: VSCode/IntelliJ plugins for schema autocomplete\n- **Testing Utilities**: Mock data generators, validation test suites\n- **Debugging Tools**: Schema diff viewers, integration trace analyzers\n\n### 🌐 **Community Resources**\n- **Schema Registry**: Searchable catalog of all available schemas and extensions\n- **Integration Examples**: Real implementations from pilot communities\n- **Cultural Adaptations**: Community-contributed localization patterns\n- **Best Practices**: Proven patterns for framework integration\n\n## Ecosystem Benefits\n\n### For **Framework Developers**\n- **Reduced Complexity**: Shared infrastructure eliminates duplicate code\n- **Type Safety**: Full TypeScript support across all integrations\n- **Consistent APIs**: Standardized patterns for data exchange\n- **Community Support**: Shared maintenance and improvement efforts\n\n### For **Application Builders**\n- **Single Dependency**: One package provides all framework integration capabilities\n- **Validated Schemas**: Runtime validation prevents integration errors\n- **Rich Examples**: Comprehensive sample code for all use cases\n- **Future-Proof**: Automatic compatibility with framework updates\n\n### For **Communities**\n- **Cultural Control**: Extension points enable community-specific adaptations\n- **Data Sovereignty**: Built-in privacy and access control mechanisms\n- **Accessibility**: Multi-modal support for diverse participation needs\n- **Interoperability**: Easy connection between different community systems\n\n## Quality Assurance\n\n### 🧪 **Testing Strategy**\n- **Unit Tests**: Every utility function and validator thoroughly tested\n- **Integration Tests**: Cross-framework compatibility continuously verified\n- **Schema Tests**: All JSON schemas validated against example data\n- **Performance Tests**: Conversion and validation speed benchmarked\n\n### 📊 **Monitoring & Metrics**\n- **Usage Analytics**: Anonymous tracking of schema adoption and usage patterns\n- **Error Reporting**: Automatic collection of validation failures for improvement\n- **Performance Monitoring**: Conversion speed and memory usage optimization\n- **Community Feedback**: Regular surveys and feedback collection from implementers\n\n### 🔄 **Continuous Integration**\n- **Automated Testing**: All commits tested against multiple framework versions\n- **Schema Validation**: Changes verified against real community data\n- **Breaking Change Detection**: Automatic alerts for compatibility issues\n- **Documentation Updates**: Auto-generated docs from schema changes\n\n## Future Roadmap\n\n### 🎯 **Short Term (Q3-Q4 2025, Q1-Q2 2026)**\n- Core schema stabilization and TypeScript definitions\n- Basic validation and conversion utilities\n- Integration with initial EGP, Love Ledger, and AUBI implementations\n- Community feedback integration and iteration\n\n### 🚀 **Medium Term (Q3-Q4 2026, Q1-Q4 2027)**\n- Advanced privacy tools and zero-knowledge proof utilities\n- Cultural adaptation frameworks and localization tools\n- Performance optimization and scalability improvements\n- Comprehensive documentation and developer resources\n\n### 🌍 **Long Term (2028+)**\n- AI-assisted schema evolution and migration tools\n- Advanced fraud detection and security utilities\n- Inter-planetary data exchange protocols (space governance integration)\n- Quantum-resistant cryptographic upgrade pathways\n\n## Contact & Resources\n\n- **Repository**: [github.com/GlobalGovernanceFrameworks/ggf-core](https://github.com/GlobalGovernanceFrameworks/ggf-core)\n- **Documentation**: [globalgovernanceframeworks.org/core](https://globalgovernanceframeworks.org/core)\n- **NPM Package**: [@bjornkennethholmstrom/ggf-core](https://npmjs.com/package/@bjornkennethholmstrom/ggf-core)\n- **Email**: contact@globalgovernanceframeworks.org\n- **Community Discord**: https://discord.gg/MjnzCfh4mM\n- **Issue Tracker**: Report bugs, request features, propose schema changes\n- **Discussion Forum**: Community chat for integration questions and collaboration\n\n## Package Name Migration\n\n**Current**: `@bjornkennethholmstrom/ggf-core`  \n**Future**: `@globalgovernanceframeworks/core` (pending NPM namespace approval)\n\nThis package will be migrated to the official organization namespace once available. \nCurrent installations will continue to work, with deprecation notices pointing to the new location.\n\n## License\n\nGGF Core is licensed under the MIT License to ensure maximum compatibility and adoption across the ecosystem, while respecting Indigenous data sovereignty principles and community ownership rights.\n\n---\n\n*\"One foundation, infinite possibilities. GGF Core enables the Global Governance Frameworks ecosystem to flourish together.\"*\n\n**Status**: Repository creation and initial schema development beginning Q1 2025. Join us in building the foundation for regenerative governance! 🏗️✨\n","readmeFilename":"README.md"}