@medicine-wheel/consent-lifecycle 0.2.2

package/README.md

@@ -0,0 +1,84 @@
+# @medicine-wheel/consent-lifecycle
+
+Ongoing relational consent lifecycle for the Medicine Wheel Developer Suite.
+
+> Consent as a living relational obligation, not a boolean checkbox.
+
+## Purpose
+
+Transforms consent from a boolean checkbox into a living relational obligation with lifecycle tracking, renewal, renegotiation, and community-level consent protocols.
+
+Wilson's relational accountability means consent is not an event — it's a *relationship*. "Once you are in relationship, you are responsible for that relationship's wellbeing." Consent must be maintained, renewed, and can be withdrawn — with cascading effects on all dependent relations.
+
+## Installation
+
+```bash
+npm install @medicine-wheel/consent-lifecycle
+```
+
+## Key Concepts
+
+### ConsentState
+
+Consent moves through a lifecycle of states:
+- `pending` — consent requested but not yet granted
+- `granted` — consent given but not yet ceremonialized
+- `active` — consent is active and honored through ceremony
+- `renewal-needed` — consent approaching expiration
+- `expired` — consent has lapsed
+- `renegotiating` — scope is being renegotiated
+- `withdrawn` — consent has been withdrawn (terminal)
+
+### Cascading Effects
+
+When consent is withdrawn or scope changes, all dependent relations are affected. The cascade module computes these effects and ensures nothing falls through the cracks.
+
+### Community Consent
+
+Community-level consent transcends individual consent. It requires collective decision-making through consensus mechanisms and may require Elder endorsement.
+
+## API
+
+### Lifecycle Module
+
+- `grantConsent(record)` — initial grant
+- `renewConsent(record)` — renew existing consent
+- `renegotiateConsent(record, newScope)` — change scope
+- `withdrawConsent(record, reason)` — withdraw with cascading effects
+- `checkConsentHealth(record)` — health assessment
+
+### Scope Module
+
+- `defineScope(description, dataTypes, purposes)` — create scope
+- `narrowScope(scope, restrictions)` — add restrictions
+- `widenScope(scope, additions)` — expand scope (requires re-consent)
+- `scopeIncludes(scope, query)` — check if action is within scope
+
+### Ceremony Module
+
+- `consentCeremony(record, participants)` — record consent ceremony
+- `consentRenewalCeremony(record, participants)` — renewal ceremony
+
+### Community Module
+
+- `communityConsent(community, scope)` — community-level consent
+- `collectiveDecision(voices)` — consensus mechanism
+- `elderApproval(elderId, record)` — Elder endorsement
+
+### Cascade Module
+
+- `onWithdrawal(record)` — compute cascading effects
+- `propagateScopeChange(record, newScope)` — update dependent relations
+- `findDependentRelations(record, allRecords)` — find dependencies
+
+### Alerts Module
+
+- `consentStaleAlert(record)` — warn when consent needs renewal
+- `renewalDue(records)` — find all records needing renewal
+- `scopeMismatch(record, action)` — detect action outside scope
+- `healthCheck(records)` — batch health check
+
+## License
+
+MIT — IAIP Collaborative, Shawinigan, QC
+

package/dist/alerts.d.ts

@@ -0,0 +1,74 @@
+/**
+ * @medicine-wheel/consent-lifecycle — Alerts Module
+ *
+ * Consent health monitoring: stale consent warnings, renewal
+ * due dates, scope mismatches, and batch health checks.
+ * Consent that goes unmonitored decays — these alerts prevent that.
+ */
+import type { ConsentRecord } from './types.js';
+import type { ConsentHealthResult } from './lifecycle.js';
+/**
+ * Check whether a consent record is stale and needs renewal.
+ * Returns a warning if consent is approaching or past expiration.
+ */
+export declare function consentStaleAlert(record: ConsentRecord): StaleAlert | null;
+/**
+ * Find all consent records that need renewal.
+ * Returns records sorted by urgency (most urgent first).
+ */
+export declare function renewalDue(records: ConsentRecord[]): RenewalDueResult;
+/**
+ * Detect whether an action falls outside the consent scope.
+ * Returns a mismatch report if the action is not covered.
+ */
+export declare function scopeMismatch(record: ConsentRecord, action: ActionDescription): ScopeMismatchResult;
+/**
+ * Batch health check across all consent records.
+ * Returns a comprehensive health report for the entire consent landscape.
+ */
+export declare function healthCheck(records: ConsentRecord[]): BatchHealthResult;
+/** Stale consent alert */
+export interface StaleAlert {
+    recordId: string;
+    severity: 'info' | 'warning' | 'critical';
+    message: string;
+    daysUntilExpiry: number | null;
+}
+/** A single renewal item */
+export interface RenewalItem {
+    recordId: string;
+    grantor: string;
+    grantee: string;
+    severity: 'info' | 'warning' | 'critical';
+    daysUntilExpiry: number | null;
+    message: string;
+}
+/** Result of renewal due check */
+export interface RenewalDueResult {
+    totalDue: number;
+    items: RenewalItem[];
+    summary: string;
+}
+/** Description of an action to check against scope */
+export interface ActionDescription {
+    dataType: string;
+    purpose: string;
+}
+/** Result of scope mismatch check */
+export interface ScopeMismatchResult {
+    mismatch: boolean;
+    issues: string[];
+    recommendation: string;
+}
+/** Batch health check result */
+export interface BatchHealthResult {
+    total: number;
+    healthy: number;
+    unhealthy: number;
+    results: Array<{
+        recordId: string;
+        health: ConsentHealthResult;
+    }>;
+    summary: string;
+}
+//# sourceMappingURL=alerts.d.ts.map

package/dist/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../src/alerts.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,IAAI,CAgD1E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,gBAAgB,CA8BrE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,iBAAiB,GACxB,mBAAmB,CAmCrB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,iBAAiB,CAmBvE;AAID,0BAA0B;AAC1B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;IAC1C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,kCAAkC;AAClC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qCAAqC;AACrC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,gCAAgC;AAChC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;IAClE,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/alerts.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * @medicine-wheel/consent-lifecycle — Alerts Module
+ *
+ * Consent health monitoring: stale consent warnings, renewal
+ * due dates, scope mismatches, and batch health checks.
+ * Consent that goes unmonitored decays — these alerts prevent that.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consentStaleAlert = consentStaleAlert;
+exports.renewalDue = renewalDue;
+exports.scopeMismatch = scopeMismatch;
+exports.healthCheck = healthCheck;
+const lifecycle_js_1 = require("./lifecycle.js");
+/**
+ * Check whether a consent record is stale and needs renewal.
+ * Returns a warning if consent is approaching or past expiration.
+ */
+function consentStaleAlert(record) {
+    if (record.state === 'withdrawn')
+        return null;
+    if (!record.expiresAt) {
+        // No expiration — check if consent has never been renewed
+        if (record.state === 'granted' && !record.renewedAt) {
+            return {
+                recordId: record.id,
+                severity: 'info',
+                message: `Consent '${record.id}' has been granted but never renewed or activated through ceremony.`,
+                daysUntilExpiry: null,
+            };
+        }
+        return null;
+    }
+    const now = Date.now();
+    const expiryTime = new Date(record.expiresAt).getTime();
+    const daysUntilExpiry = Math.ceil((expiryTime - now) / 86400000);
+    if (daysUntilExpiry <= 0) {
+        return {
+            recordId: record.id,
+            severity: 'critical',
+            message: `Consent '${record.id}' has EXPIRED. Immediate renewal required.`,
+            daysUntilExpiry,
+        };
+    }
+    if (daysUntilExpiry <= 7) {
+        return {
+            recordId: record.id,
+            severity: 'warning',
+            message: `Consent '${record.id}' expires in ${daysUntilExpiry} day(s). Schedule renewal ceremony.`,
+            daysUntilExpiry,
+        };
+    }
+    if (daysUntilExpiry <= 30) {
+        return {
+            recordId: record.id,
+            severity: 'info',
+            message: `Consent '${record.id}' expires in ${daysUntilExpiry} day(s). Plan for renewal.`,
+            daysUntilExpiry,
+        };
+    }
+    return null;
+}
+/**
+ * Find all consent records that need renewal.
+ * Returns records sorted by urgency (most urgent first).
+ */
+function renewalDue(records) {
+    const due = [];
+    for (const record of records) {
+        if (record.state === 'withdrawn')
+            continue;
+        const alert = consentStaleAlert(record);
+        if (alert) {
+            due.push({
+                recordId: record.id,
+                grantor: record.grantor,
+                grantee: record.grantee,
+                severity: alert.severity,
+                daysUntilExpiry: alert.daysUntilExpiry,
+                message: alert.message,
+            });
+        }
+    }
+    // Sort by urgency: critical first, then warning, then info
+    const severityOrder = { critical: 0, warning: 1, info: 2 };
+    due.sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity]);
+    return {
+        totalDue: due.length,
+        items: due,
+        summary: due.length === 0
+            ? 'No consent records need renewal.'
+            : `${due.length} consent record(s) need attention: ${due.filter((d) => d.severity === 'critical').length} critical, ${due.filter((d) => d.severity === 'warning').length} warning.`,
+    };
+}
+/**
+ * Detect whether an action falls outside the consent scope.
+ * Returns a mismatch report if the action is not covered.
+ */
+function scopeMismatch(record, action) {
+    const issues = [];
+    // Check state first
+    if (record.state !== 'active' && record.state !== 'granted') {
+        issues.push(`Consent is in '${record.state}' state — not active.`);
+    }
+    // Check data type
+    if (!record.scope.dataTypes.some((dt) => dt === action.dataType || dt === '*')) {
+        issues.push(`Data type '${action.dataType}' not in consented data types.`);
+    }
+    // Check purpose
+    if (!record.scope.purposes.some((p) => p === action.purpose || p === '*')) {
+        issues.push(`Purpose '${action.purpose}' not in consented purposes.`);
+    }
+    // Check restrictions
+    for (const restriction of record.scope.restrictions) {
+        if (restriction.toLowerCase().includes(action.dataType.toLowerCase()) ||
+            restriction.toLowerCase().includes(action.purpose.toLowerCase())) {
+            issues.push(`Action may violate restriction: '${restriction}'.`);
+        }
+    }
+    return {
+        mismatch: issues.length > 0,
+        issues,
+        recommendation: issues.length > 0
+            ? 'This action exceeds the current consent scope. Renegotiate consent before proceeding.'
+            : 'Action is within consent scope.',
+    };
+}
+/**
+ * Batch health check across all consent records.
+ * Returns a comprehensive health report for the entire consent landscape.
+ */
+function healthCheck(records) {
+    const results = [];
+    let healthyCount = 0;
+    let unhealthyCount = 0;
+    for (const record of records) {
+        const health = (0, lifecycle_js_1.checkConsentHealth)(record);
+        results.push({ recordId: record.id, health });
+        if (health.healthy)
+            healthyCount++;
+        else
+            unhealthyCount++;
+    }
+    return {
+        total: records.length,
+        healthy: healthyCount,
+        unhealthy: unhealthyCount,
+        results,
+        summary: `${healthyCount}/${records.length} consent records healthy. ${unhealthyCount} need attention.`,
+    };
+}
+//# sourceMappingURL=alerts.js.map

package/dist/alerts.js.map

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

package/dist/cascade.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @medicine-wheel/consent-lifecycle — Cascade Module
+ *
+ * Manages cascading effects of consent changes. When consent
+ * is withdrawn or scope changes, all dependent relations must
+ * be updated. This honors the interconnected nature of consent.
+ */
+import type { ConsentRecord, ConsentScope, ConsentCascade } from './types.js';
+/**
+ * Compute the cascading effects of consent withdrawal.
+ * All dependent relations must be notified and updated.
+ */
+export declare function onWithdrawal(record: ConsentRecord): ConsentCascade;
+/**
+ * Propagate a scope change to all dependent relations.
+ * Determines whether dependent relations need review or narrowing.
+ */
+export declare function propagateScopeChange(record: ConsentRecord, newScope: ConsentScope): ScopeChangeResult;
+/**
+ * Find all relations that depend on a given consent record.
+ * Returns the dependent relation IDs with their dependency nature.
+ */
+export declare function findDependentRelations(record: ConsentRecord, allRecords: ConsentRecord[]): DependencyResult;
+/** Details of how a dependent relation is affected */
+export interface AffectedRelation {
+    relationId: string;
+    action: 'narrow' | 'review' | 'withdraw' | 'expire';
+    reason: string;
+}
+/** Result of scope change propagation */
+export interface ScopeChangeResult {
+    cascade: ConsentCascade;
+    narrowed: boolean;
+    widened: boolean;
+    affectedRelations: AffectedRelation[];
+    requiresReconsent: boolean;
+    summary: string;
+}
+/** Result of dependency analysis */
+export interface DependencyResult {
+    directCount: number;
+    transitiveCount: number;
+    directDependents: string[];
+    transitiveDependents: string[];
+    totalAffected: number;
+    summary: string;
+}
+//# sourceMappingURL=cascade.d.ts.map

package/dist/cascade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cascade.d.ts","sourceRoot":"","sources":["../src/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAMlE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,YAAY,GACrB,iBAAiB,CA8BnB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,aAAa,EAAE,GAC1B,gBAAgB,CA2BlB;AAID,sDAAsD;AACtD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/cascade.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * @medicine-wheel/consent-lifecycle — Cascade Module
+ *
+ * Manages cascading effects of consent changes. When consent
+ * is withdrawn or scope changes, all dependent relations must
+ * be updated. This honors the interconnected nature of consent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onWithdrawal = onWithdrawal;
+exports.propagateScopeChange = propagateScopeChange;
+exports.findDependentRelations = findDependentRelations;
+/**
+ * Compute the cascading effects of consent withdrawal.
+ * All dependent relations must be notified and updated.
+ */
+function onWithdrawal(record) {
+    return {
+        triggerId: record.id,
+        affected: [...record.dependentRelations],
+        action: 'withdraw',
+    };
+}
+/**
+ * Propagate a scope change to all dependent relations.
+ * Determines whether dependent relations need review or narrowing.
+ */
+function propagateScopeChange(record, newScope) {
+    const narrowed = isNarrower(record.scope, newScope);
+    const widened = isWider(record.scope, newScope);
+    const cascade = {
+        triggerId: record.id,
+        affected: [...record.dependentRelations],
+        action: narrowed ? 'narrow' : 'review',
+    };
+    const affectedDetails = record.dependentRelations.map((relId) => ({
+        relationId: relId,
+        action: narrowed ? 'narrow' : 'review',
+        reason: narrowed
+            ? 'Parent consent scope narrowed — dependent scope must be reviewed.'
+            : 'Parent consent scope changed — dependent relations need review.',
+    }));
+    return {
+        cascade,
+        narrowed,
+        widened,
+        affectedRelations: affectedDetails,
+        requiresReconsent: widened,
+        summary: record.dependentRelations.length === 0
+            ? 'No dependent relations affected by scope change.'
+            : `${record.dependentRelations.length} dependent relation(s) affected. Action: ${cascade.action}.`,
+    };
+}
+/**
+ * Find all relations that depend on a given consent record.
+ * Returns the dependent relation IDs with their dependency nature.
+ */
+function findDependentRelations(record, allRecords) {
+    // Direct dependents
+    const directDependents = record.dependentRelations;
+    // Transitive dependents: relations that depend on our dependents
+    const transitiveDependents = [];
+    for (const depId of directDependents) {
+        const depRecord = allRecords.find((r) => r.id === depId);
+        if (depRecord) {
+            for (const transId of depRecord.dependentRelations) {
+                if (!directDependents.includes(transId) && !transitiveDependents.includes(transId)) {
+                    transitiveDependents.push(transId);
+                }
+            }
+        }
+    }
+    return {
+        directCount: directDependents.length,
+        transitiveCount: transitiveDependents.length,
+        directDependents,
+        transitiveDependents,
+        totalAffected: directDependents.length + transitiveDependents.length,
+        summary: directDependents.length === 0
+            ? 'No dependent relations found.'
+            : `${directDependents.length} direct and ${transitiveDependents.length} transitive dependent(s).`,
+    };
+}
+// ── Internal Helpers ────────────────────────────────────────────────────────
+function isNarrower(oldScope, newScope) {
+    const fewerTypes = newScope.dataTypes.length < oldScope.dataTypes.length;
+    const fewerPurposes = newScope.purposes.length < oldScope.purposes.length;
+    const moreRestrictions = newScope.restrictions.length > oldScope.restrictions.length;
+    return fewerTypes || fewerPurposes || moreRestrictions;
+}
+function isWider(oldScope, newScope) {
+    const moreTypes = newScope.dataTypes.some((t) => !oldScope.dataTypes.includes(t));
+    const morePurposes = newScope.purposes.some((p) => !oldScope.purposes.includes(p));
+    const fewerRestrictions = oldScope.restrictions.some((r) => !newScope.restrictions.includes(r));
+    return moreTypes || morePurposes || fewerRestrictions;
+}
+//# sourceMappingURL=cascade.js.map

package/dist/cascade.js.map

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

package/dist/ceremony.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @medicine-wheel/consent-lifecycle — Ceremony Module
+ *
+ * Records consent ceremonies — the relational acts that formalize
+ * consent granting, renewal, and withdrawal. Ceremony honors
+ * the relational nature of consent.
+ */
+import type { ConsentRecord } from './types.js';
+/**
+ * Record a consent ceremony for initial consent granting.
+ * Transitions the consent record to 'active' state and logs
+ * the ceremony with participants and witnesses.
+ */
+export declare function consentCeremony(record: ConsentRecord, participants: string[], options?: ConsentCeremonyOptions): ConsentRecord;
+/**
+ * Record a consent renewal ceremony.
+ * Resets the consent expiration and transitions to 'active' state.
+ */
+export declare function consentRenewalCeremony(record: ConsentRecord, participants: string[], options?: ConsentCeremonyOptions): ConsentRecord;
+/** Options for consent ceremony recording */
+export interface ConsentCeremonyOptions {
+    witnessedBy?: string[];
+    notes?: string;
+    ceremonyId?: string;
+}
+//# sourceMappingURL=ceremony.d.ts.map

package/dist/ceremony.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ceremony.d.ts","sourceRoot":"","sources":["../src/ceremony.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EAId,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,aAAa,CA4Bf;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EAAE,EACtB,OAAO,CAAC,EAAE,sBAAsB,GAC/B,aAAa,CAwCf;AAID,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/ceremony.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @medicine-wheel/consent-lifecycle — Ceremony Module
+ *
+ * Records consent ceremonies — the relational acts that formalize
+ * consent granting, renewal, and withdrawal. Ceremony honors
+ * the relational nature of consent.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.consentCeremony = consentCeremony;
+exports.consentRenewalCeremony = consentRenewalCeremony;
+/**
+ * Record a consent ceremony for initial consent granting.
+ * Transitions the consent record to 'active' state and logs
+ * the ceremony with participants and witnesses.
+ */
+function consentCeremony(record, participants, options) {
+    const now = new Date().toISOString();
+    const ceremony = {
+        type: 'initial',
+        timestamp: now,
+        participants,
+        witnessedBy: options?.witnessedBy ?? [],
+        outcome: 'active',
+        notes: options?.notes,
+        ceremonyId: options?.ceremonyId,
+    };
+    const change = {
+        from: record.state,
+        to: 'active',
+        reason: 'Consent ceremony conducted — consent is now active.',
+        timestamp: now,
+        initiatedBy: record.grantor,
+    };
+    return {
+        ...record,
+        state: 'active',
+        grantedAt: record.grantedAt ?? now,
+        ceremonies: [...record.ceremonies, ceremony],
+        history: [...record.history, change],
+    };
+}
+/**
+ * Record a consent renewal ceremony.
+ * Resets the consent expiration and transitions to 'active' state.
+ */
+function consentRenewalCeremony(record, participants, options) {
+    const validStates = ['active', 'granted', 'renewal-needed'];
+    if (!validStates.includes(record.state)) {
+        throw new Error(`Cannot conduct renewal ceremony for consent in state '${record.state}'.`);
+    }
+    const now = new Date().toISOString();
+    const ceremony = {
+        type: 'renewal',
+        timestamp: now,
+        participants,
+        witnessedBy: options?.witnessedBy ?? [],
+        outcome: 'active',
+        notes: options?.notes,
+        ceremonyId: options?.ceremonyId,
+    };
+    const change = {
+        from: record.state,
+        to: 'active',
+        reason: 'Consent renewal ceremony conducted.',
+        timestamp: now,
+        initiatedBy: record.grantor,
+    };
+    const expiresAt = record.renewalInterval
+        ? new Date(Date.now() + record.renewalInterval * 86400000).toISOString()
+        : record.expiresAt;
+    return {
+        ...record,
+        state: 'active',
+        renewedAt: now,
+        expiresAt,
+        ceremonies: [...record.ceremonies, ceremony],
+        history: [...record.history, change],
+    };
+}
+//# sourceMappingURL=ceremony.js.map

package/dist/ceremony.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ceremony.js","sourceRoot":"","sources":["../src/ceremony.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAcH,0CAgCC;AAMD,wDA4CC;AAvFD;;;;GAIG;AACH,SAAgB,eAAe,CAC7B,MAAqB,EACrB,YAAsB,EACtB,OAAgC;IAEhC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAoB;QAChC,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,GAAG;QACd,YAAY;QACZ,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;QACvC,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;IAEF,MAAM,MAAM,GAAuB;QACjC,IAAI,EAAE,MAAM,CAAC,KAAK;QAClB,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,qDAAqD;QAC7D,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,MAAM,CAAC,OAAO;KAC5B,CAAC;IAEF,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;QAClC,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC5C,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,MAAqB,EACrB,YAAsB,EACtB,OAAgC;IAEhC,MAAM,WAAW,GAAmB,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;IAC5E,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,yDAAyD,MAAM,CAAC,KAAK,IAAI,CAC1E,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,QAAQ,GAAoB;QAChC,IAAI,EAAE,SAAS;QACf,SAAS,EAAE,GAAG;QACd,YAAY;QACZ,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;QACvC,OAAO,EAAE,QAAQ;QACjB,KAAK,EAAE,OAAO,EAAE,KAAK;QACrB,UAAU,EAAE,OAAO,EAAE,UAAU;KAChC,CAAC;IAEF,MAAM,MAAM,GAAuB;QACjC,IAAI,EAAE,MAAM,CAAC,KAAK;QAClB,EAAE,EAAE,QAAQ;QACZ,MAAM,EAAE,qCAAqC;QAC7C,SAAS,EAAE,GAAG;QACd,WAAW,EAAE,MAAM,CAAC,OAAO;KAC5B,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe;QACtC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,eAAe,GAAG,QAAQ,CAAC,CAAC,WAAW,EAAE;QACxE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IAErB,OAAO;QACL,GAAG,MAAM;QACT,KAAK,EAAE,QAAQ;QACf,SAAS,EAAE,GAAG;QACd,SAAS;QACT,UAAU,EAAE,CAAC,GAAG,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC5C,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC;KACrC,CAAC;AACJ,CAAC"}

package/dist/community.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @medicine-wheel/consent-lifecycle — Community Module
+ *
+ * Community-level consent operations: collective consent,
+ * consensus mechanisms, and Elder endorsement.
+ * Community consent transcends individual consent — it represents
+ * the collective voice of the community.
+ */
+import type { ConsentRecord, ConsentScope } from './types.js';
+/**
+ * Create a community-level consent record.
+ * Community consent represents collective agreement, not just
+ * individual grantor/grantee relations.
+ */
+export declare function communityConsent(community: CommunityInfo, scope: ConsentScope): ConsentRecord;
+/**
+ * Consensus mechanism for collective decision-making.
+ * Collects voices and determines whether consensus is reached.
+ */
+export declare function collectiveDecision(voices: CommunityVoice[]): ConsensusResult;
+/**
+ * Record Elder approval for a consent record.
+ * Elder endorsement carries special weight in Indigenous governance.
+ */
+export declare function elderApproval(elderId: string, record: ConsentRecord, options?: ElderApprovalOptions): ConsentRecord;
+/** Information about the community granting consent */
+export interface CommunityInfo {
+    name: string;
+    grantee: string;
+    initiatedBy: string;
+}
+/** A community member's voice in collective decision-making */
+export interface CommunityVoice {
+    name: string;
+    role: string;
+    position: 'approve' | 'object' | 'abstain';
+    reason?: string;
+}
+/** Result of a collective consensus process */
+export interface ConsensusResult {
+    consensusReached: boolean;
+    approvalCount: number;
+    objectionCount: number;
+    abstainCount: number;
+    totalVoices: number;
+    objections?: Array<{
+        voice: string;
+        reason: string;
+    }>;
+    summary: string;
+}
+/** Options for Elder approval */
+export interface ElderApprovalOptions {
+    blessing?: string;
+    conditions?: string[];
+}
+//# sourceMappingURL=community.d.ts.map

package/dist/community.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"community.d.ts","sourceRoot":"","sources":["../src/community.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,aAAa,EACxB,KAAK,EAAE,YAAY,GAClB,aAAa,CA2Bf;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,eAAe,CAiC5E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,EACrB,OAAO,CAAC,EAAE,oBAAoB,GAC7B,aAAa,CAef;AAID,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,iCAAiC;AACjC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB"}