@medicine-wheel/consent-lifecycle 0.2.2

package/dist/community.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * @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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.communityConsent = communityConsent;
+exports.collectiveDecision = collectiveDecision;
+exports.elderApproval = elderApproval;
+/**
+ * Create a community-level consent record.
+ * Community consent represents collective agreement, not just
+ * individual grantor/grantee relations.
+ */
+function communityConsent(community, scope) {
+    const now = new Date().toISOString();
+    return {
+        id: `community-consent-${Date.now()}`,
+        grantor: community.name,
+        grantee: community.grantee,
+        scope,
+        state: 'pending',
+        ceremonies: [],
+        history: [{
+                from: 'pending',
+                to: 'pending',
+                reason: 'Community consent record created — awaiting collective decision.',
+                timestamp: now,
+                initiatedBy: community.initiatedBy,
+            }],
+        communityLevel: true,
+        dependentRelations: [],
+        ocapFlags: {
+            ownership: community.name,
+            control: community.name,
+            access: 'community',
+            possession: 'community-server',
+            compliant: false,
+        },
+    };
+}
+/**
+ * Consensus mechanism for collective decision-making.
+ * Collects voices and determines whether consensus is reached.
+ */
+function collectiveDecision(voices) {
+    if (voices.length === 0) {
+        return {
+            consensusReached: false,
+            approvalCount: 0,
+            objectionCount: 0,
+            abstainCount: 0,
+            totalVoices: 0,
+            summary: 'No voices recorded. Consensus requires community participation.',
+        };
+    }
+    const approvals = voices.filter((v) => v.position === 'approve');
+    const objections = voices.filter((v) => v.position === 'object');
+    const abstentions = voices.filter((v) => v.position === 'abstain');
+    // Consensus requires no objections (not just majority)
+    const consensusReached = objections.length === 0 && approvals.length > 0;
+    return {
+        consensusReached,
+        approvalCount: approvals.length,
+        objectionCount: objections.length,
+        abstainCount: abstentions.length,
+        totalVoices: voices.length,
+        objections: objections.map((v) => ({
+            voice: v.name,
+            reason: v.reason ?? 'No reason given',
+        })),
+        summary: consensusReached
+            ? `Consensus reached with ${approvals.length} approval(s) and ${abstentions.length} abstention(s).`
+            : `Consensus not reached: ${objections.length} objection(s). All concerns must be addressed.`,
+    };
+}
+/**
+ * Record Elder approval for a consent record.
+ * Elder endorsement carries special weight in Indigenous governance.
+ */
+function elderApproval(elderId, record, options) {
+    const now = new Date().toISOString();
+    const change = {
+        from: record.state,
+        to: record.state, // Elder approval doesn't change state directly
+        reason: `Elder endorsement by ${elderId}${options?.blessing ? `: ${options.blessing}` : ''}`,
+        timestamp: now,
+        initiatedBy: elderId,
+    };
+    return {
+        ...record,
+        history: [...record.history, change],
+    };
+}
+//# sourceMappingURL=community.js.map

package/dist/community.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @medicine-wheel/consent-lifecycle
+ *
+ * Ongoing relational consent lifecycle for the Medicine Wheel Developer Suite.
+ * Consent as a living relational obligation, not a boolean checkbox.
+ *
+ * @packageDocumentation
+ */
+export type { ConsentState, ConsentRecord, ConsentScope, ConsentCeremony, ConsentStateChange, ConsentCascade, } from './types.js';
+export { ConsentStateSchema, ConsentScopeSchema, ConsentCeremonySchema, ConsentStateChangeSchema, ConsentCascadeSchema, ConsentRecordSchema, } from './schemas.js';
+export type { ValidatedConsentRecord, ValidatedConsentScope, ValidatedConsentCeremony, ValidatedConsentStateChange, ValidatedConsentCascade, } from './schemas.js';
+export { grantConsent, renewConsent, renegotiateConsent, withdrawConsent, checkConsentHealth, } from './lifecycle.js';
+export type { ConsentHealthResult } from './lifecycle.js';
+export { defineScope, narrowScope, widenScope, scopeIncludes, } from './scope.js';
+export type { ScopeAdditions, WidenScopeResult, ScopeQuery, ScopeCheckResult, } from './scope.js';
+export { consentCeremony, consentRenewalCeremony, } from './ceremony.js';
+export type { ConsentCeremonyOptions } from './ceremony.js';
+export { communityConsent, collectiveDecision, elderApproval, } from './community.js';
+export type { CommunityInfo, CommunityVoice, ConsensusResult, ElderApprovalOptions, } from './community.js';
+export { onWithdrawal, propagateScopeChange, findDependentRelations, } from './cascade.js';
+export type { AffectedRelation, ScopeChangeResult, DependencyResult, } from './cascade.js';
+export { consentStaleAlert, renewalDue, scopeMismatch, healthCheck, } from './alerts.js';
+export type { StaleAlert, RenewalItem, RenewalDueResult, ActionDescription, ScopeMismatchResult, BatchHealthResult, } from './alerts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,2BAA2B,EAC3B,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,kBAAkB,GACnB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG1D,OAAO,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,UAAU,EACV,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,eAAe,EACf,sBAAsB,GACvB,MAAM,eAAe,CAAC;AAEvB,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAG5D,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,aAAa,EACb,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,53 @@
+"use strict";
+/**
+ * @medicine-wheel/consent-lifecycle
+ *
+ * Ongoing relational consent lifecycle for the Medicine Wheel Developer Suite.
+ * Consent as a living relational obligation, not a boolean checkbox.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.healthCheck = exports.scopeMismatch = exports.renewalDue = exports.consentStaleAlert = exports.findDependentRelations = exports.propagateScopeChange = exports.onWithdrawal = exports.elderApproval = exports.collectiveDecision = exports.communityConsent = exports.consentRenewalCeremony = exports.consentCeremony = exports.scopeIncludes = exports.widenScope = exports.narrowScope = exports.defineScope = exports.checkConsentHealth = exports.withdrawConsent = exports.renegotiateConsent = exports.renewConsent = exports.grantConsent = exports.ConsentRecordSchema = exports.ConsentCascadeSchema = exports.ConsentStateChangeSchema = exports.ConsentCeremonySchema = exports.ConsentScopeSchema = exports.ConsentStateSchema = void 0;
+// ── Schemas ─────────────────────────────────────────────────────────────────
+var schemas_js_1 = require("./schemas.js");
+Object.defineProperty(exports, "ConsentStateSchema", { enumerable: true, get: function () { return schemas_js_1.ConsentStateSchema; } });
+Object.defineProperty(exports, "ConsentScopeSchema", { enumerable: true, get: function () { return schemas_js_1.ConsentScopeSchema; } });
+Object.defineProperty(exports, "ConsentCeremonySchema", { enumerable: true, get: function () { return schemas_js_1.ConsentCeremonySchema; } });
+Object.defineProperty(exports, "ConsentStateChangeSchema", { enumerable: true, get: function () { return schemas_js_1.ConsentStateChangeSchema; } });
+Object.defineProperty(exports, "ConsentCascadeSchema", { enumerable: true, get: function () { return schemas_js_1.ConsentCascadeSchema; } });
+Object.defineProperty(exports, "ConsentRecordSchema", { enumerable: true, get: function () { return schemas_js_1.ConsentRecordSchema; } });
+// ── Lifecycle ───────────────────────────────────────────────────────────────
+var lifecycle_js_1 = require("./lifecycle.js");
+Object.defineProperty(exports, "grantConsent", { enumerable: true, get: function () { return lifecycle_js_1.grantConsent; } });
+Object.defineProperty(exports, "renewConsent", { enumerable: true, get: function () { return lifecycle_js_1.renewConsent; } });
+Object.defineProperty(exports, "renegotiateConsent", { enumerable: true, get: function () { return lifecycle_js_1.renegotiateConsent; } });
+Object.defineProperty(exports, "withdrawConsent", { enumerable: true, get: function () { return lifecycle_js_1.withdrawConsent; } });
+Object.defineProperty(exports, "checkConsentHealth", { enumerable: true, get: function () { return lifecycle_js_1.checkConsentHealth; } });
+// ── Scope ───────────────────────────────────────────────────────────────────
+var scope_js_1 = require("./scope.js");
+Object.defineProperty(exports, "defineScope", { enumerable: true, get: function () { return scope_js_1.defineScope; } });
+Object.defineProperty(exports, "narrowScope", { enumerable: true, get: function () { return scope_js_1.narrowScope; } });
+Object.defineProperty(exports, "widenScope", { enumerable: true, get: function () { return scope_js_1.widenScope; } });
+Object.defineProperty(exports, "scopeIncludes", { enumerable: true, get: function () { return scope_js_1.scopeIncludes; } });
+// ── Ceremony ────────────────────────────────────────────────────────────────
+var ceremony_js_1 = require("./ceremony.js");
+Object.defineProperty(exports, "consentCeremony", { enumerable: true, get: function () { return ceremony_js_1.consentCeremony; } });
+Object.defineProperty(exports, "consentRenewalCeremony", { enumerable: true, get: function () { return ceremony_js_1.consentRenewalCeremony; } });
+// ── Community ───────────────────────────────────────────────────────────────
+var community_js_1 = require("./community.js");
+Object.defineProperty(exports, "communityConsent", { enumerable: true, get: function () { return community_js_1.communityConsent; } });
+Object.defineProperty(exports, "collectiveDecision", { enumerable: true, get: function () { return community_js_1.collectiveDecision; } });
+Object.defineProperty(exports, "elderApproval", { enumerable: true, get: function () { return community_js_1.elderApproval; } });
+// ── Cascade ─────────────────────────────────────────────────────────────────
+var cascade_js_1 = require("./cascade.js");
+Object.defineProperty(exports, "onWithdrawal", { enumerable: true, get: function () { return cascade_js_1.onWithdrawal; } });
+Object.defineProperty(exports, "propagateScopeChange", { enumerable: true, get: function () { return cascade_js_1.propagateScopeChange; } });
+Object.defineProperty(exports, "findDependentRelations", { enumerable: true, get: function () { return cascade_js_1.findDependentRelations; } });
+// ── Alerts ──────────────────────────────────────────────────────────────────
+var alerts_js_1 = require("./alerts.js");
+Object.defineProperty(exports, "consentStaleAlert", { enumerable: true, get: function () { return alerts_js_1.consentStaleAlert; } });
+Object.defineProperty(exports, "renewalDue", { enumerable: true, get: function () { return alerts_js_1.renewalDue; } });
+Object.defineProperty(exports, "scopeMismatch", { enumerable: true, get: function () { return alerts_js_1.scopeMismatch; } });
+Object.defineProperty(exports, "healthCheck", { enumerable: true, get: function () { return alerts_js_1.healthCheck; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAYH,+EAA+E;AAC/E,2CAOsB;AANpB,gHAAA,kBAAkB,OAAA;AAClB,gHAAA,kBAAkB,OAAA;AAClB,mHAAA,qBAAqB,OAAA;AACrB,sHAAA,wBAAwB,OAAA;AACxB,kHAAA,oBAAoB,OAAA;AACpB,iHAAA,mBAAmB,OAAA;AAWrB,+EAA+E;AAC/E,+CAMwB;AALtB,4GAAA,YAAY,OAAA;AACZ,4GAAA,YAAY,OAAA;AACZ,kHAAA,kBAAkB,OAAA;AAClB,+GAAA,eAAe,OAAA;AACf,kHAAA,kBAAkB,OAAA;AAKpB,+EAA+E;AAC/E,uCAKoB;AAJlB,uGAAA,WAAW,OAAA;AACX,uGAAA,WAAW,OAAA;AACX,sGAAA,UAAU,OAAA;AACV,yGAAA,aAAa,OAAA;AAUf,+EAA+E;AAC/E,6CAGuB;AAFrB,8GAAA,eAAe,OAAA;AACf,qHAAA,sBAAsB,OAAA;AAKxB,+EAA+E;AAC/E,+CAIwB;AAHtB,gHAAA,gBAAgB,OAAA;AAChB,kHAAA,kBAAkB,OAAA;AAClB,6GAAA,aAAa,OAAA;AAUf,+EAA+E;AAC/E,2CAIsB;AAHpB,0GAAA,YAAY,OAAA;AACZ,kHAAA,oBAAoB,OAAA;AACpB,oHAAA,sBAAsB,OAAA;AASxB,+EAA+E;AAC/E,yCAKqB;AAJnB,8GAAA,iBAAiB,OAAA;AACjB,uGAAA,UAAU,OAAA;AACV,0GAAA,aAAa,OAAA;AACb,wGAAA,WAAW,OAAA"}

package/dist/lifecycle.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @medicine-wheel/consent-lifecycle — Lifecycle Module
+ *
+ * Core consent lifecycle operations: grant, renew, renegotiate,
+ * withdraw, and health assessment. Consent is a living relationship,
+ * not a one-time event.
+ */
+import type { ConsentRecord, ConsentState, ConsentScope } from './types.js';
+/**
+ * Grant initial consent, transitioning from 'pending' to 'granted'.
+ * Sets the grantedAt timestamp and computes expiration if renewalInterval is set.
+ */
+export declare function grantConsent(record: ConsentRecord): ConsentRecord;
+/**
+ * Renew existing consent, resetting the expiration clock.
+ * Consent must be in 'active', 'granted', or 'renewal-needed' state.
+ */
+export declare function renewConsent(record: ConsentRecord): ConsentRecord;
+/**
+ * Renegotiate consent with a new scope.
+ * Transitions to 'renegotiating' until the new scope is accepted.
+ * The new scope replaces the old scope once finalized.
+ */
+export declare function renegotiateConsent(record: ConsentRecord, newScope: ConsentScope): ConsentRecord;
+/**
+ * Withdraw consent with a reason. This is a terminal action that
+ * triggers cascading effects on all dependent relations.
+ */
+export declare function withdrawConsent(record: ConsentRecord, reason: string): ConsentRecord;
+/**
+ * Check the health of a consent record.
+ * Evaluates whether consent is current, properly renewed, and
+ * within scope. Returns a health assessment with recommendations.
+ */
+export declare function checkConsentHealth(record: ConsentRecord): ConsentHealthResult;
+/** Result of a consent health check */
+export interface ConsentHealthResult {
+    healthy: boolean;
+    state: ConsentState;
+    issues: string[];
+    daysUntilExpiry: number | null;
+    needsRenewal: boolean;
+    recommendations: string[];
+}
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAqBjE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CA4BjE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,YAAY,GACrB,aAAa,CAoBf;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACb,aAAa,CAef;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,GAAG,mBAAmB,CAiE7E;AAID,uCAAuC;AACvC,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B"}

package/dist/lifecycle.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * @medicine-wheel/consent-lifecycle — Lifecycle Module
+ *
+ * Core consent lifecycle operations: grant, renew, renegotiate,
+ * withdraw, and health assessment. Consent is a living relationship,
+ * not a one-time event.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.grantConsent = grantConsent;
+exports.renewConsent = renewConsent;
+exports.renegotiateConsent = renegotiateConsent;
+exports.withdrawConsent = withdrawConsent;
+exports.checkConsentHealth = checkConsentHealth;
+/**
+ * Grant initial consent, transitioning from 'pending' to 'granted'.
+ * Sets the grantedAt timestamp and computes expiration if renewalInterval is set.
+ */
+function grantConsent(record) {
+    const now = new Date().toISOString();
+    const change = {
+        from: record.state,
+        to: 'granted',
+        reason: 'Initial consent granted',
+        timestamp: now,
+        initiatedBy: record.grantor,
+    };
+    const expiresAt = record.renewalInterval
+        ? new Date(Date.now() + record.renewalInterval * 86400000).toISOString()
+        : record.expiresAt;
+    return {
+        ...record,
+        state: 'granted',
+        grantedAt: now,
+        expiresAt,
+        history: [...record.history, change],
+    };
+}
+/**
+ * Renew existing consent, resetting the expiration clock.
+ * Consent must be in 'active', 'granted', or 'renewal-needed' state.
+ */
+function renewConsent(record) {
+    const validStates = ['active', 'granted', 'renewal-needed'];
+    if (!validStates.includes(record.state)) {
+        throw new Error(`Cannot renew consent in state '${record.state}'. Must be one of: ${validStates.join(', ')}`);
+    }
+    const now = new Date().toISOString();
+    const change = {
+        from: record.state,
+        to: 'active',
+        reason: 'Consent renewed',
+        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,
+        history: [...record.history, change],
+    };
+}
+/**
+ * Renegotiate consent with a new scope.
+ * Transitions to 'renegotiating' until the new scope is accepted.
+ * The new scope replaces the old scope once finalized.
+ */
+function renegotiateConsent(record, newScope) {
+    if (record.state === 'withdrawn') {
+        throw new Error('Cannot renegotiate withdrawn consent. A new consent must be created.');
+    }
+    const now = new Date().toISOString();
+    const change = {
+        from: record.state,
+        to: 'renegotiating',
+        reason: `Scope renegotiation initiated: ${newScope.description}`,
+        timestamp: now,
+        initiatedBy: record.grantor,
+    };
+    return {
+        ...record,
+        state: 'renegotiating',
+        scope: newScope,
+        history: [...record.history, change],
+    };
+}
+/**
+ * Withdraw consent with a reason. This is a terminal action that
+ * triggers cascading effects on all dependent relations.
+ */
+function withdrawConsent(record, reason) {
+    const now = new Date().toISOString();
+    const change = {
+        from: record.state,
+        to: 'withdrawn',
+        reason,
+        timestamp: now,
+        initiatedBy: record.grantor,
+    };
+    return {
+        ...record,
+        state: 'withdrawn',
+        history: [...record.history, change],
+    };
+}
+/**
+ * Check the health of a consent record.
+ * Evaluates whether consent is current, properly renewed, and
+ * within scope. Returns a health assessment with recommendations.
+ */
+function checkConsentHealth(record) {
+    const issues = [];
+    const now = Date.now();
+    // State checks
+    if (record.state === 'withdrawn') {
+        return {
+            healthy: false,
+            state: record.state,
+            issues: ['Consent has been withdrawn.'],
+            daysUntilExpiry: null,
+            needsRenewal: false,
+            recommendations: ['A new consent must be created if the relationship is to continue.'],
+        };
+    }
+    if (record.state === 'expired') {
+        issues.push('Consent has expired and must be renewed.');
+    }
+    if (record.state === 'pending') {
+        issues.push('Consent is still pending — not yet granted.');
+    }
+    // Expiry checks
+    let daysUntilExpiry = null;
+    let needsRenewal = false;
+    if (record.expiresAt) {
+        const expiryTime = new Date(record.expiresAt).getTime();
+        daysUntilExpiry = Math.ceil((expiryTime - now) / 86400000);
+        if (daysUntilExpiry <= 0) {
+            issues.push('Consent has expired.');
+            needsRenewal = true;
+        }
+        else if (daysUntilExpiry <= 30) {
+            issues.push(`Consent expires in ${daysUntilExpiry} day(s).`);
+            needsRenewal = true;
+        }
+    }
+    // Ceremony checks
+    if (record.ceremonies.length === 0) {
+        issues.push('No consent ceremonies recorded. Ceremony strengthens consent relations.');
+    }
+    // OCAP checks
+    if (!record.ocapFlags.compliant) {
+        issues.push('OCAP® compliance not verified.');
+    }
+    const healthy = issues.length === 0 && record.state === 'active';
+    const recommendations = [];
+    if (needsRenewal)
+        recommendations.push('Schedule a consent renewal ceremony.');
+    if (!record.ocapFlags.compliant)
+        recommendations.push('Verify OCAP® compliance.');
+    if (record.ceremonies.length === 0)
+        recommendations.push('Conduct a consent ceremony.');
+    return {
+        healthy,
+        state: record.state,
+        issues,
+        daysUntilExpiry,
+        needsRenewal,
+        recommendations,
+    };
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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