@popmelt.com/core 0.8.4 → 0.8.6

package/dist/memory-legacy.d.mts

@@ -0,0 +1,446 @@
+declare const MEMORY_FORMAT_VERSION: 1;
+declare const MEMORY_SCHEMA_VERSION: 1;
+type MemoryFormatVersion = typeof MEMORY_FORMAT_VERSION;
+type MemorySchemaVersion = typeof MEMORY_SCHEMA_VERSION;
+type MemoryId = string;
+type Timestamp = string;
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+type SourceReferenceKind = 'thread' | 'message' | 'iteration' | 'artifact' | 'event' | 'record' | 'external';
+type SourceReference = {
+    kind: SourceReferenceKind;
+    id: string;
+    uri?: string;
+    excerpt?: string;
+};
+type Provenance = {
+    id: MemoryId;
+    schemaVersion: MemorySchemaVersion;
+    projectId: MemoryId;
+    createdAt: Timestamp;
+    participantId: MemoryId;
+    sourceRefs: SourceReference[];
+};
+type ParticipantKind = 'human' | 'ai' | 'system' | 'integration';
+type AuthorityLevel = 'owner' | 'delegate' | 'contributor';
+type AuthorityMode = 'local_trusted' | 'hosted';
+type ExecutionContext = {
+    sessionId?: string;
+    provider?: string;
+    model?: string;
+    deviceId?: string;
+    mode?: string;
+};
+type AuthorityContext = {
+    level: AuthorityLevel;
+    mode: AuthorityMode;
+    grantId?: MemoryId;
+    authenticatedAt?: Timestamp;
+};
+type ParticipantRecord = Provenance & {
+    recordType: 'participant';
+    kind: ParticipantKind;
+    displayName: string;
+    status: 'active' | 'disabled';
+};
+type AuthorityGrantRecord = Provenance & {
+    recordType: 'authority_grant';
+    granteeId: MemoryId;
+    level: AuthorityLevel;
+    grantedById: MemoryId;
+    subjectIds: MemoryId[];
+    startsAt: Timestamp;
+    endsAt?: Timestamp;
+    revokedAt?: Timestamp;
+};
+type SubjectType = 'project' | 'file' | 'route' | 'component' | 'element' | 'token' | 'interaction';
+type SubjectLocatorKind = 'project_root' | 'source_file' | 'route_pattern' | 'file_export' | 'source_span' | 'dom_selector' | 'token_path' | 'interaction_key' | 'custom';
+type SubjectLocator = {
+    id: MemoryId;
+    kind: SubjectLocatorKind;
+    value: string;
+    status: 'current' | 'historical' | 'unresolved';
+    validFrom: Timestamp;
+    validUntil?: Timestamp;
+    sourceRefs: SourceReference[];
+};
+type SubjectRecord = Provenance & {
+    recordType: 'subject';
+    subjectType: SubjectType;
+    label: string;
+    aliases: string[];
+    locators: SubjectLocator[];
+};
+type ParticipantStance = {
+    stance: 'supports' | 'opposes' | 'uncertain' | 'needs_evidence';
+    reason?: string;
+};
+type CaptureContext = {
+    route?: string;
+    subjectIds: MemoryId[];
+    artifactIds: MemoryId[];
+};
+type ObservationState = 'open' | 'resolved' | 'dismissed';
+type ObservationRecord = Provenance & {
+    recordType: 'observation';
+    state: ObservationState;
+    statement: string;
+    captureContext: CaptureContext;
+    stance?: ParticipantStance;
+    resolvedByIds: MemoryId[];
+};
+type DecisionKind = 'principle' | 'preference' | 'rule' | 'constraint';
+type ProposalState = 'draft' | 'pending' | 'accepted' | 'rejected' | 'withdrawn' | 'deferred';
+type AssertionOrigin = {
+    mode: 'declared' | 'inferred';
+    sourceText?: string;
+    iterationId?: MemoryId;
+    inferredById?: MemoryId;
+    reviewedById?: MemoryId;
+};
+type DecisionSubject = {
+    subjectId: MemoryId;
+    role: 'governed' | 'consumer' | 'provider' | 'context';
+};
+type ProposalRecord = Provenance & {
+    recordType: 'proposal';
+    state: ProposalState;
+    claim: string;
+    rationale?: string;
+    proposedKind?: DecisionKind;
+    subjects: DecisionSubject[];
+    subjectSemantics?: string;
+    origin: AssertionOrigin;
+    stance?: ParticipantStance;
+    bundleId?: MemoryId;
+};
+type DecisionState = 'active' | 'superseded' | 'revoked';
+type DecisionRecord = Provenance & {
+    recordType: 'decision';
+    proposalId: MemoryId;
+    acceptanceEventId: MemoryId;
+    acceptedById: MemoryId;
+    authority: AuthorityContext;
+    state: DecisionState;
+    kind: DecisionKind;
+    claim: string;
+    rationale?: string;
+    subjects: DecisionSubject[];
+    subjectSemantics?: string;
+    noChange: boolean;
+    effectiveAt?: Timestamp;
+    effectiveMilestone?: string;
+    bundleId?: MemoryId;
+};
+type ThreadOutcome = 'decision_created' | 'proposal_rejected' | 'observation_resolved' | 'observation_dismissed' | 'question_unresolved' | 'implementation_only' | 'no_outcome';
+type ThreadRecord = Provenance & {
+    recordType: 'thread';
+    title?: string;
+    state: 'open' | 'resolved';
+    messageArtifactIds: MemoryId[];
+    outcome: ThreadOutcome;
+    resultRefs: EntityReference[];
+};
+type IterationOutcome = 'completed' | 'cancelled' | 'question_asked' | 'failed' | 'no_change';
+type IterationRecord = Provenance & {
+    recordType: 'iteration';
+    threadIds: MemoryId[];
+    startedAt: Timestamp;
+    completedAt?: Timestamp;
+    requestSummary: string;
+    responseSummary?: string;
+    outcome: IterationOutcome;
+    execution: ExecutionContext;
+    artifactIds: MemoryId[];
+};
+type EvidenceKind = 'judgment' | 'artifact' | 'eval' | 'log' | 'user_feedback' | 'external_source' | 'project_state';
+type EvidenceRecord = Provenance & {
+    recordType: 'evidence';
+    kind: EvidenceKind;
+    summary: string;
+    availability: 'available' | 'missing' | 'redacted' | 'forgotten';
+    stance?: ParticipantStance;
+    artifactIds: MemoryId[];
+};
+type CoverageClaim = {
+    decisionId: MemoryId;
+    coverage: 'partial' | 'full';
+    claim: string;
+    sourceRefs: SourceReference[];
+};
+type ImplementationState = 'planned' | 'in_progress' | 'completed' | 'failed' | 'abandoned';
+type ImplementationAttemptRecord = Provenance & {
+    recordType: 'implementation_attempt';
+    state: ImplementationState;
+    iterationIds: MemoryId[];
+    coverageClaims: CoverageClaim[];
+    projectStateRef?: SourceReference;
+    summary: string;
+    artifactIds: MemoryId[];
+};
+type VerificationState = 'queued' | 'running' | 'passed' | 'failed' | 'inconclusive' | 'error' | 'cancelled';
+type VerificationTarget = {
+    entityType: 'decision' | 'implementation_attempt' | 'model_entry';
+    entityId: MemoryId;
+};
+type EvalSpecState = 'draft' | 'active' | 'retired';
+type EvalDependency = {
+    kind: 'model_path' | 'source_file' | 'route' | 'subject';
+    value: string;
+    subjectId?: MemoryId;
+};
+type EvalScenario = {
+    id: string;
+    label?: string;
+    route?: string;
+    routePattern?: string;
+    components?: Array<{
+        name: string;
+        sourceFile?: string;
+        exportName?: string;
+    }>;
+    subjectIds?: MemoryId[];
+    states?: Array<{
+        kind: 'viewport' | 'theme' | 'auth' | 'locale' | 'feature_flag' | 'fixture' | 'interaction' | 'custom';
+        key?: string;
+        value: string;
+    }>;
+    steps?: Array<{
+        action: 'navigate' | 'click' | 'type' | 'select';
+        target?: string;
+        value?: string;
+    }>;
+};
+type EvalSpecRecord = Provenance & {
+    recordType: 'eval_spec';
+    state: EvalSpecState;
+    legacyId: string;
+    replacesSpecId?: MemoryId;
+    title: string;
+    category: 'component' | 'layout' | 'copy' | 'interaction' | 'visual' | 'workflow';
+    prompt: string;
+    assertions: string[];
+    rationale: string;
+    decisionIds: MemoryId[];
+    subjectIds: MemoryId[];
+    threadRefs: string[];
+    dependencies?: EvalDependency[];
+    scenarios?: EvalScenario[];
+    targets: VerificationTarget[];
+    evaluator: {
+        kind: 'human' | 'ai' | 'test' | 'external';
+        name: string;
+        evidenceTypes: string[];
+    };
+    scope: {
+        kind: 'current_page' | 'project' | 'subject';
+        route?: string;
+    };
+};
+type VerificationAttemptRecord = Provenance & {
+    recordType: 'verification_attempt';
+    evalSpecId?: MemoryId;
+    scopeFingerprint?: string;
+    state: VerificationState;
+    evaluator: {
+        kind: 'human' | 'ai' | 'test' | 'eval' | 'external';
+        participantId?: MemoryId;
+        name: string;
+    };
+    targets: VerificationTarget[];
+    summary?: string;
+    evidenceIds: MemoryId[];
+    /** Compact presentation data for an eval run; raw output remains an artifact/thread detail. */
+    evalRun?: {
+        id: string;
+        threadId?: string;
+        createdAt: number;
+        completedAt: number;
+        durationMs: number;
+        scope: {
+            type: 'current_page';
+            url: string;
+            viewport: {
+                width: number;
+                height: number;
+            };
+        };
+        assertionResults: Array<{
+            assertion: string;
+            status: 'pass' | 'fail' | 'needs_review';
+            summary: string;
+            evidence: string[];
+        }>;
+        tooling: {
+            chromeDevtools: 'available' | 'unavailable' | 'unknown';
+            evidenceTypes: string[];
+        };
+        provider?: string;
+        model?: string;
+        screenshotPath?: string;
+        codeFingerprint?: string;
+    };
+};
+type ModelEntryRecord = Provenance & {
+    recordType: 'model_entry';
+    key: string;
+    subjectIds: MemoryId[];
+    decisionIds: MemoryId[];
+    value: JsonValue;
+};
+type ModelProjectionRecord = Provenance & {
+    recordType: 'model_projection';
+    state: 'applied';
+    runId: string;
+    presentationJobId?: string;
+    appliedById: MemoryId;
+    authority: AuthorityContext;
+    appliedAt: Timestamp;
+    decisionIds: MemoryId[];
+    entryIds: MemoryId[];
+    coverage: Array<{
+        decisionId: MemoryId;
+        status: 'unprojected' | 'partially_projected' | 'projected' | 'stale';
+    }>;
+};
+type EntityType = 'participant' | 'authority_grant' | 'subject' | 'observation' | 'proposal' | 'decision' | 'thread' | 'iteration' | 'evidence' | 'implementation_attempt' | 'eval_spec' | 'verification_attempt' | 'model_entry' | 'model_projection' | 'freshness_signal';
+type MemoryObjectType = EntityType | 'relationship' | 'lifecycle_event' | 'artifact';
+type EntityReference = {
+    entityType: EntityType;
+    entityId: MemoryId;
+};
+type RelationshipType = 'supports' | 'contradicts' | 'supersedes' | 'excepts' | 'duplicates' | 'implements' | 'verifies' | 'replaces' | 'derived_from';
+type RelationshipRecord = Provenance & {
+    recordType: 'relationship';
+    relationshipType: RelationshipType;
+    from: EntityReference;
+    to: EntityReference;
+    reason: string;
+    authority?: AuthorityContext;
+};
+type FreshnessSignalType = 'subject_unresolved' | 'implementation_drift' | 'evidence_unavailable' | 'new_conflict' | 'verification_expired' | 'review_interval_elapsed' | 'schema_or_tooling_change';
+type FreshnessTargetKind = 'subject_locator' | 'implementation_presence' | 'verification_result' | 'model_coverage' | 'evidence_reference' | 'decision_applicability';
+type FreshnessSignalRecord = Provenance & {
+    recordType: 'freshness_signal';
+    signalType: FreshnessSignalType;
+    state: 'open' | 'resolved';
+    targetKind: FreshnessTargetKind;
+    target: EntityReference;
+    reason: string;
+    evidenceIds: MemoryId[];
+    resolvedAt?: Timestamp;
+    resolvedByEventId?: MemoryId;
+};
+type ProposalDeferralContext = {
+    kind: 'proposal_deferral';
+    taskContext?: string;
+    subjectIds: MemoryId[];
+    resurfaceWhen: Array<'different_action' | 'new_evidence' | 'new_conflict' | 'owner_request' | 'after_date'>;
+    revisitAfter?: Timestamp;
+};
+type LifecycleEvent = Provenance & {
+    recordType: 'lifecycle_event';
+    entity: EntityReference;
+    eventType: string;
+    fromState: string | null;
+    toState: string;
+    authority: AuthorityContext;
+    execution?: ExecutionContext;
+    reason?: string;
+    transitionContext?: ProposalDeferralContext;
+};
+type ArtifactKind = 'message' | 'screenshot' | 'image' | 'diff' | 'file_snapshot' | 'log' | 'eval_output' | 'external_document' | 'other';
+type ArtifactManifestEntry = {
+    id: MemoryId;
+    kind: ArtifactKind;
+    mediaType?: string;
+    byteSize?: number;
+    contentHash?: string;
+    location?: string;
+    availability: 'available' | 'missing' | 'redacted' | 'forgotten';
+};
+type Tombstone = {
+    id: MemoryId;
+    schemaVersion: MemorySchemaVersion;
+    projectId: MemoryId;
+    objectId: MemoryId;
+    objectType: MemoryObjectType;
+    deletedAt: Timestamp;
+    deletedById: MemoryId;
+    authority: AuthorityContext;
+    reasonCategory: 'privacy' | 'legal' | 'serious_error' | 'intentional_forgetting';
+    erasureLevel: 'content' | 'content_and_evidence' | 'full_where_permitted';
+    invalidates: EntityReference[];
+};
+type CanonicalRecord = ParticipantRecord | AuthorityGrantRecord | SubjectRecord | ObservationRecord | ProposalRecord | DecisionRecord | ThreadRecord | IterationRecord | EvidenceRecord | ImplementationAttemptRecord | EvalSpecRecord | VerificationAttemptRecord | ModelEntryRecord | ModelProjectionRecord | FreshnessSignalRecord;
+type MemoryFeature = 'authority' | 'subjects' | 'decisions' | 'implementations' | 'verification' | 'eval_specs' | 'model_projection' | 'freshness' | 'portable_artifacts' | 'bounded_retrieval';
+type ProjectMemoryManifest = {
+    formatVersion: MemoryFormatVersion;
+    projectId: MemoryId;
+    createdAt: Timestamp;
+    updatedAt: Timestamp;
+    features: MemoryFeature[];
+    writer: {
+        name: string;
+        version: string;
+    };
+};
+type ProjectMemoryBundle = {
+    manifest: ProjectMemoryManifest;
+    records: CanonicalRecord[];
+    events: LifecycleEvent[];
+    relationships: RelationshipRecord[];
+    artifacts: ArtifactManifestEntry[];
+    tombstones: Tombstone[];
+};
+
+type SchemaIssue = {
+    path: string;
+    code: string;
+    message: string;
+    severity: 'error' | 'warning';
+};
+
+type LegacyImportIssue = {
+    severity: 'info' | 'warning' | 'error';
+    code: string;
+    source?: string;
+    message: string;
+};
+type LegacyImportReport = {
+    projectRoot: string;
+    source: {
+        threads: number;
+        messages: number;
+        decisionEnvelopes: number;
+        modelEntries: number;
+        artifactsReferenced: number;
+    };
+    imported: Record<string, number>;
+    unresolvedAcceptance: number;
+    deferredModelEntries: number;
+    proofCases: Array<{
+        legacyId: string;
+        threadFound: boolean;
+        decisionEnvelopeFound: boolean;
+        recordIds: string[];
+    }>;
+    issues: LegacyImportIssue[];
+    schemaIssues: SchemaIssue[];
+};
+type LegacyImportResult = {
+    bundle: ProjectMemoryBundle;
+    report: LegacyImportReport;
+};
+type LegacyImportOptions = {
+    projectRoot: string;
+    projectKey?: string;
+    proofCaseIds?: string[];
+    writerVersion?: string;
+};
+declare function legacyUuidV7(namespace: string, kind: string, legacyId: string, occurredAt: number): string;
+declare function importLegacyProject(options: LegacyImportOptions): Promise<LegacyImportResult>;
+
+export { type LegacyImportIssue, type LegacyImportOptions, type LegacyImportReport, type LegacyImportResult, importLegacyProject, legacyUuidV7 };

package/dist/memory-legacy.mjs

@@ -0,0 +1 @@
+import{createHash as Me}from"crypto";import{readFile as Le,readdir as Pe,realpath as Be}from"fs/promises";import{join as X,relative as De}from"path";var Ae=/^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;function Se(n){return Ae.test(n)}function Re(n){return{valid:!n.some(e=>e.severity==="error"),issues:n}}function d(n,e,i,m){n.push({path:e,code:i,message:m,severity:"error"})}function oe(n,e,i,m){n.push({path:e,code:i,message:m,severity:"warning"})}function I(n,e,i){Se(i)||d(n,e,"invalid_uuid_v7","Canonical IDs must be UUIDv7 values.")}function P(n,e,i){(!i||Number.isNaN(Date.parse(i)))&&d(n,e,"invalid_timestamp","Timestamps must be parseable ISO-8601 strings.")}function D(n,e,i,m=!1){m&&i.level==="contributor"&&d(n,`${e}.level`,"insufficient_authority","Contributors cannot accept or change normative product truth."),i.level==="delegate"&&!i.grantId&&d(n,`${e}.grantId`,"missing_authority_grant","Delegate authority must reference the grant used for this action.")}var Ee={observation:new Set(["null->open","open->resolved","open->dismissed","resolved->open","dismissed->open"]),proposal:new Set(["null->draft","draft->pending","pending->accepted","pending->rejected","pending->withdrawn","pending->deferred","deferred->pending"]),decision:new Set(["null->active","active->superseded","active->revoked"]),implementation_attempt:new Set(["null->planned","planned->in_progress","planned->abandoned","in_progress->completed","in_progress->failed","in_progress->abandoned"]),eval_spec:new Set(["null->draft","null->active","draft->active","draft->retired","active->retired"]),verification_attempt:new Set(["null->queued","queued->running","queued->cancelled","running->passed","running->failed","running->inconclusive","running->error","running->cancelled"]),freshness_signal:new Set(["null->open","open->resolved"])},we=new Set(["proposal:accepted","proposal:rejected","decision:superseded","decision:revoked"]);function xe(n,e,i){I(n,`${i}.id`,e.id),I(n,`${i}.projectId`,e.projectId),I(n,`${i}.participantId`,e.participantId),I(n,`${i}.entity.entityId`,e.entity.entityId),P(n,`${i}.createdAt`,e.createdAt),D(n,`${i}.authority`,e.authority);let m=Ee[e.entity.entityType],$=`${e.fromState??"null"}->${e.toState}`;m&&!m.has($)&&d(n,i,"invalid_lifecycle_transition",`${e.entity.entityType} does not allow ${$}.`);let j=`${e.entity.entityType}:${e.toState}`;if(we.has(j)&&(D(n,`${i}.authority`,e.authority,!0),e.reason?.trim()||d(n,`${i}.reason`,"missing_normative_reason","Normative acceptance, rejection, supersession, and revocation require a reason.")),e.entity.entityType==="proposal"&&e.toState==="deferred"){let g=e.transitionContext;(g?.kind!=="proposal_deferral"||g.resurfaceWhen.length===0)&&d(n,`${i}.transitionContext`,"missing_deferral_policy","Deferred proposals require structured resurfacing conditions."),g?.resurfaceWhen.includes("after_date")&&!g.revisitAfter&&d(n,`${i}.transitionContext.revisitAfter`,"missing_revisit_date","after_date resurfacing requires revisitAfter."),g?.revisitAfter&&P(n,`${i}.transitionContext.revisitAfter`,g.revisitAfter)}}function ke(n,e,i,m){I(n,`${i}.id`,e.id),I(n,`${i}.projectId`,e.projectId),I(n,`${i}.participantId`,e.participantId),P(n,`${i}.createdAt`,e.createdAt),e.projectId!==m&&d(n,`${i}.projectId`,"project_mismatch","Record belongs to another project."),"subjects"in e&&e.subjects.length===0&&d(n,`${i}.subjects`,"missing_subject","Proposals and decisions need a subject."),"subjects"in e&&e.subjects.length>1&&!e.subjectSemantics?.trim()&&d(n,`${i}.subjectSemantics`,"missing_subject_semantics","Multi-subject claims must explain why the subjects are inseparable."),e.recordType==="proposal"&&e.origin.mode==="inferred"&&(!e.origin.sourceText||!e.origin.iterationId||!e.origin.inferredById)&&d(n,`${i}.origin`,"incomplete_inference_provenance","Inferred structure requires source text, iteration, and inferring participant."),e.recordType==="decision"&&(D(n,`${i}.authority`,e.authority,!0),e.claim.trim()||d(n,`${i}.claim`,"empty_claim","Accepted decisions require a claim.")),e.recordType==="authority_grant"&&e.level==="owner"&&oe(n,`${i}.level`,"owner_grant_requires_policy_review","Owner grants are valid but should receive explicit policy review."),e.recordType==="freshness_signal"&&e.state==="resolved"&&(!e.resolvedAt||!e.resolvedByEventId)&&d(n,i,"incomplete_freshness_resolution","Resolved freshness signals need a time and resolving event."),e.recordType==="model_projection"&&(P(n,`${i}.appliedAt`,e.appliedAt),D(n,`${i}.authority`,e.authority,!0),e.entryIds.length===0&&d(n,`${i}.entryIds`,"empty_model_projection","Applied model projections need at least one model entry.")),e.recordType==="eval_spec"&&((!e.legacyId.trim()||!e.title.trim()||!e.prompt.trim())&&d(n,i,"incomplete_eval_spec","Eval specs need a stable id, title, and prompt."),(e.assertions.length===0||e.assertions.some($=>!$.trim()))&&d(n,`${i}.assertions`,"empty_eval_assertions","Eval specs need at least one non-empty assertion."),e.targets.length===0&&e.decisionIds.length===0&&oe(n,i,"unbound_eval_spec","Eval spec is not yet bound to canonical product truth."),(e.dependencies?.length??0)===0&&oe(n,`${i}.dependencies`,"unscoped_eval_spec","Eval spec has no freshness dependencies."))}function Ce(n,e,i){I(n,`${i}.id`,e.id),I(n,`${i}.projectId`,e.projectId),I(n,`${i}.participantId`,e.participantId),I(n,`${i}.from.entityId`,e.from.entityId),I(n,`${i}.to.entityId`,e.to.entityId),P(n,`${i}.createdAt`,e.createdAt),e.reason.trim()||d(n,`${i}.reason`,"missing_relationship_reason","Relationships need a reason."),new Set(["supports","contradicts","supersedes","excepts"]).has(e.relationshipType)&&((e.from.entityType!=="decision"||e.to.entityType!=="decision")&&d(n,i,"invalid_normative_relationship","Normative relationships connect decisions to decisions."),e.authority?D(n,`${i}.authority`,e.authority,!0):d(n,`${i}.authority`,"missing_relationship_authority","Normative relationships require explicit authority context.")),e.relationshipType==="implements"&&(e.from.entityType!=="implementation_attempt"||e.to.entityType!=="decision")&&d(n,i,"invalid_implements_relationship","`implements` points from an implementation attempt to a decision."),e.relationshipType==="verifies"&&(e.from.entityType!=="verification_attempt"||!["decision","implementation_attempt","model_entry"].includes(e.to.entityType))&&d(n,i,"invalid_verifies_relationship","`verifies` points from a verification attempt to a verifiable target."),e.relationshipType==="replaces"&&e.from.entityType!==e.to.entityType&&d(n,i,"invalid_replaces_relationship","`replaces` connects records of the same entity type.")}function ye(n){let e=[];I(e,"manifest.projectId",n.manifest.projectId),P(e,"manifest.createdAt",n.manifest.createdAt),P(e,"manifest.updatedAt",n.manifest.updatedAt);let i=new Map,m=(t,a)=>{let s=i.get(t);s?d(e,a,"duplicate_id",`ID is already used at ${s}.`):i.set(t,a)};n.records.forEach((t,a)=>{let s=`records[${a}]`;m(t.id,s),ke(e,t,s,n.manifest.projectId)}),n.events.forEach((t,a)=>{let s=`events[${a}]`;m(t.id,s),xe(e,t,s),t.projectId!==n.manifest.projectId&&d(e,`${s}.projectId`,"project_mismatch","Event belongs to another project.")}),n.relationships.forEach((t,a)=>{let s=`relationships[${a}]`;m(t.id,s),Ce(e,t,s),t.projectId!==n.manifest.projectId&&d(e,`${s}.projectId`,"project_mismatch","Relationship belongs to another project.")}),n.artifacts.forEach((t,a)=>{m(t.id,`artifacts[${a}]`),I(e,`artifacts[${a}].id`,t.id)}),n.tombstones.forEach((t,a)=>{let s=`tombstones[${a}]`;m(t.id,s),I(e,`${s}.id`,t.id),I(e,`${s}.objectId`,t.objectId),I(e,`${s}.deletedById`,t.deletedById),P(e,`${s}.deletedAt`,t.deletedAt),D(e,`${s}.authority`,t.authority,!0)});let $=new Set(n.records.map(t=>`${t.recordType}:${t.id}`)),j=new Set(n.tombstones.map(t=>`${t.objectType}:${t.objectId}`)),g=(t,a)=>{let s=`${t.entityType}:${t.entityId}`;!$.has(s)&&!j.has(s)&&d(e,a,"dangling_entity_reference",`No record or tombstone exists for ${s}.`)};n.events.forEach((t,a)=>g(t.entity,`events[${a}].entity`)),n.relationships.forEach((t,a)=>{g(t.from,`relationships[${a}].from`),g(t.to,`relationships[${a}].to`)});let Q=new Set(n.artifacts.map(t=>t.id)),S=(t,a)=>{Q.has(t)||d(e,a,"dangling_artifact_reference","No artifact manifest entry exists.")},u=(t,a,s)=>{!$.has(`${t}:${a}`)&&!j.has(`${t}:${a}`)&&d(e,s,"dangling_entity_reference",`No ${t} record or tombstone exists.`)};n.records.forEach((t,a)=>{let s=`records[${a}]`;switch(t.recordType){case"authority_grant":u("participant",t.granteeId,`${s}.granteeId`),u("participant",t.grantedById,`${s}.grantedById`),t.subjectIds.forEach((r,o)=>u("subject",r,`${s}.subjectIds[${o}]`));break;case"observation":t.captureContext.subjectIds.forEach((r,o)=>u("subject",r,`${s}.captureContext.subjectIds[${o}]`)),t.captureContext.artifactIds.forEach((r,o)=>S(r,`${s}.captureContext.artifactIds[${o}]`));break;case"proposal":case"decision":t.subjects.forEach((r,o)=>u("subject",r.subjectId,`${s}.subjects[${o}].subjectId`));break;case"thread":t.messageArtifactIds.forEach((r,o)=>S(r,`${s}.messageArtifactIds[${o}]`)),t.resultRefs.forEach((r,o)=>g(r,`${s}.resultRefs[${o}]`));break;case"iteration":t.threadIds.forEach((r,o)=>u("thread",r,`${s}.threadIds[${o}]`)),t.artifactIds.forEach((r,o)=>S(r,`${s}.artifactIds[${o}]`));break;case"evidence":t.artifactIds.forEach((r,o)=>S(r,`${s}.artifactIds[${o}]`));break;case"implementation_attempt":t.iterationIds.forEach((r,o)=>u("iteration",r,`${s}.iterationIds[${o}]`)),t.coverageClaims.forEach((r,o)=>u("decision",r.decisionId,`${s}.coverageClaims[${o}].decisionId`)),t.artifactIds.forEach((r,o)=>S(r,`${s}.artifactIds[${o}]`));break;case"eval_spec":t.replacesSpecId&&u("eval_spec",t.replacesSpecId,`${s}.replacesSpecId`),t.decisionIds.forEach((r,o)=>u("decision",r,`${s}.decisionIds[${o}]`)),t.subjectIds.forEach((r,o)=>u("subject",r,`${s}.subjectIds[${o}]`)),(t.dependencies??[]).forEach((r,o)=>{r.kind==="subject"&&r.subjectId&&u("subject",r.subjectId,`${s}.dependencies[${o}].subjectId`)}),(t.scenarios??[]).forEach((r,o)=>{r.subjectIds?.forEach((f,x)=>u("subject",f,`${s}.scenarios[${o}].subjectIds[${x}]`))}),t.targets.forEach((r,o)=>u(r.entityType,r.entityId,`${s}.targets[${o}]`));break;case"verification_attempt":t.evalSpecId&&u("eval_spec",t.evalSpecId,`${s}.evalSpecId`),t.targets.forEach((r,o)=>u(r.entityType,r.entityId,`${s}.targets[${o}]`)),t.evidenceIds.forEach((r,o)=>u("evidence",r,`${s}.evidenceIds[${o}]`));break;case"model_entry":t.subjectIds.forEach((r,o)=>u("subject",r,`${s}.subjectIds[${o}]`)),t.decisionIds.forEach((r,o)=>u("decision",r,`${s}.decisionIds[${o}]`));break;case"model_projection":D(e,`${s}.authority`,t.authority,!0),u("participant",t.appliedById,`${s}.appliedById`),t.decisionIds.forEach((r,o)=>u("decision",r,`${s}.decisionIds[${o}]`)),t.entryIds.forEach((r,o)=>u("model_entry",r,`${s}.entryIds[${o}]`)),t.coverage.forEach((r,o)=>u("decision",r.decisionId,`${s}.coverage[${o}].decisionId`));break;case"freshness_signal":g(t.target,`${s}.target`),t.evidenceIds.forEach((r,o)=>u("evidence",r,`${s}.evidenceIds[${o}]`));break;default:break}});let ne=new Map(n.events.map(t=>[t.id,t])),M=new Map(n.records.map(t=>[`${t.recordType}:${t.id}`,t])),q=new Map;n.events.forEach((t,a)=>{let s=`${t.entity.entityType}:${t.entity.entityId}:${t.fromState??"null"}`,r=q.get(s)??new Set;r.add(t.toState),q.set(s,r),r.size>1&&d(e,`events[${a}]`,"concurrent_incompatible_transitions","The same entity state has multiple incompatible successor states.")});let _=new Map(n.records.flatMap(t=>t.recordType==="authority_grant"?[[t.id,t]]:[])),h=(t,a,s,r,o)=>{if(t.level!=="delegate"||!t.grantId)return;let f=_.get(t.grantId);if(!f){d(e,o,"invalid_authority_grant","Delegated authority references a missing grant.");return}(f.granteeId!==a||f.level!=="delegate")&&d(e,o,"authority_grantee_mismatch","The grant does not authorize this participant as a delegate.");let x=Date.parse(s);(x<Date.parse(f.startsAt)||f.endsAt&&x>Date.parse(f.endsAt)||f.revokedAt&&x>=Date.parse(f.revokedAt))&&d(e,o,"inactive_authority_grant","The delegated authority grant was not active at this time."),f.subjectIds.length&&r.length&&!r.every(W=>f.subjectIds.includes(W))&&d(e,o,"authority_scope_mismatch","The delegated action exceeds the grant subject scope.")};for(let t of n.records)t.recordType==="decision"&&h(t.authority,t.acceptedById,t.createdAt,t.subjects.map(a=>a.subjectId),`records:${t.id}.authority`);n.events.forEach((t,a)=>{let s=M.get(`${t.entity.entityType}:${t.entity.entityId}`),r=s&&"subjects"in s?s.subjects.map(o=>o.subjectId):[];h(t.authority,t.participantId,t.createdAt,r,`events[${a}].authority`)}),n.relationships.forEach((t,a)=>{if(!t.authority)return;let s=[t.from,t.to].flatMap(r=>{let o=M.get(`${r.entityType}:${r.entityId}`);return o&&"subjects"in o?o.subjects.map(f=>f.subjectId):[]});h(t.authority,t.participantId,t.createdAt,s,`relationships[${a}].authority`)});for(let t of n.records){if(t.recordType!=="decision")continue;let a=ne.get(t.acceptanceEventId);(!a||a.entity.entityType!=="proposal"||a.entity.entityId!==t.proposalId||a.toState!=="accepted")&&d(e,`records:${t.id}.acceptanceEventId`,"invalid_acceptance_event","A decision must reference the proposal event that explicitly accepted it."),a&&a.participantId!==t.acceptedById&&d(e,`records:${t.id}.acceptedById`,"acceptor_mismatch","Decision acceptor must match the acceptance event participant."),M.has(`proposal:${t.proposalId}`)||d(e,`records:${t.id}.proposalId`,"missing_proposal","Accepted decisions must retain their proposal."),t.state==="superseded"&&(n.relationships.some(r=>r.relationshipType==="supersedes"&&r.to.entityType==="decision"&&r.to.entityId===t.id)||d(e,`records:${t.id}.state`,"missing_successor","Superseded decisions require an explicit successor relationship.")),t.state==="revoked"&&(n.events.some(r=>r.entity.entityType==="decision"&&r.entity.entityId===t.id&&r.toState==="revoked"&&!!r.reason?.trim())||d(e,`records:${t.id}.state`,"missing_revocation_event","Revoked decisions require an authorized event with a reason."))}for(let t of n.records){if(t.recordType!=="proposal"||t.state!=="accepted")continue;n.records.some(s=>s.recordType==="decision"&&s.proposalId===t.id)||d(e,`records:${t.id}.state`,"accepted_proposal_without_decision","Every accepted proposal must produce an immutable decision.")}return Re(e)}var qe=["f5258a13","31ffc15e","3eae3a70","c185e614","33930045","55e04c59","f3bb881b","f8a55928","eac95a7d","e402bdc2","2854624b","cf28ad45","6a494fab","987e901b","ad7293aa","dd1d5d77","14c429d6","48494ad3","d6bbe932","e8b94260","f56fa283","7f1f6cb3","f239f4ac","bd671e61","dbe032ec","c0808b95"];function K(n){return n!==null&&typeof n=="object"&&!Array.isArray(n)?n:null}function A(n,e=0){return new Date(Number.isFinite(n)?n:e).toISOString()}function he(...n){return n.find(e=>!!e?.trim())?.trim()}function b(n,e,i,m){let j=Math.max(0,Math.min(Math.floor(m),0xffffffffffff)).toString(16).padStart(12,"0"),g=Me("sha256").update(`${n}\0${e}\0${i}`).digest("hex"),Q=(Number.parseInt(g[3],16)&3|8).toString(16);return`${j.slice(0,8)}-${j.slice(8)}-7${g.slice(0,3)}-${Q}${g.slice(4,7)}-${g.slice(7,19)}`}async function ae(n,e){try{return JSON.parse(await Le(n,"utf8"))}catch(i){return e.push({severity:"warning",code:"source_unavailable",source:n,message:i instanceof Error?i.message:String(i)}),null}}function Ne(n){let e=K(n);if(!e)return 0;let i=0,m=$=>{let j=K($);if(!j){i+=1;return}for(let g of Object.values(j))m(g)};for(let $ of Object.values(e))m($);return i}function Oe(n){let e={};for(let i of n)e[i.recordType]=(e[i.recordType]??0)+1;return e}async function Ve(n){let e=[],i=await Be(n.projectRoot).catch(()=>n.projectRoot),m=X(i,".popmelt"),$=await ae(X(m,"threads.json"),e),j=await ae(X(m,"model.json"),e),g=K($),Q=K(g?.threads)??{},S=Object.entries(Q).map(([c,p])=>({key:c,value:K(p)})).filter(c=>!!c.value),u=X(m,"decisions"),ne=await Pe(u).catch(()=>[]),M=[];for(let c of ne.filter(p=>p.endsWith(".json")).sort()){let p=K(await ae(X(u,c),e));p&&M.push({file:c,value:p})}let q=S.flatMap(({value:c})=>[c.createdAt,c.updatedAt]).filter(c=>typeof c=="number"&&Number.isFinite(c)),_=q.length?Math.min(...q):0,h=n.projectKey??i;n.projectKey||e.push({severity:"info",code:"path_derived_project_identity",message:"Canonical project identity is stable for this path; pass projectKey to preserve it across moves."});let t=b(h,"project",h,_),a=b(h,"participant","legacy-owner",_),s=b(h,"participant","legacy-agent",_),r=b(h,"subject","project",_),o=A(Math.max(_,...q)),f=[],x=[],W=new Map,z=new Map,ce=new Map(M.map(c=>[c.value.id??c.file.replace(/^d-|\.json$/g,""),c.value])),ie=new Map,Y=(c,p,l,v,R)=>{let k=W.get(l);if(k)return k;let L=b(h,"artifact",c,v);return x.push({id:L,kind:p,mediaType:R,location:l,availability:"available"}),W.set(l,L),L};for(let{file:c,value:p}of M){let l=p.id??c.replace(/^d-|\.json$/g,""),v=p.createdAt??_,R=[Y(`${l}:envelope`,"other",`.popmelt/decisions/${c}`,v,"application/json")];p.screenshotPath&&R.push(Y(`${l}:screenshot`,"screenshot",`.popmelt/${p.screenshotPath.replace(/^\.popmelt\//,"")}`,v,p.screenshotPath.endsWith(".png")?"image/png":"image/webp"));for(let[k,L]of(p.pastedImagePaths??[]).entries())R.push(Y(`${l}:image:${k}`,"image",L,v));ie.set(l,R)}let C=(c,p,l)=>({id:c,schemaVersion:1,projectId:t,createdAt:o,participantId:p,sourceRefs:l}),Z=(c,p)=>{f.push(p);let l=z.get(c)??[];l.push(p.id),z.set(c,l)},Ie=[{...C(a,a,[]),recordType:"participant",kind:"human",displayName:"Legacy project owner",status:"active"},{...C(s,s,[]),recordType:"participant",kind:"ai",displayName:"Legacy coding agent",status:"active"}];f.push(...Ie),f.push({...C(r,a,[]),recordType:"subject",subjectType:"project",label:De(process.cwd(),i)||i,aliases:[],locators:[{id:b(h,"locator",i,_),kind:"project_root",value:i,status:"current",validFrom:A(_),sourceRefs:[]}]});let de=new Map,pe=(c,p)=>{let l=de.get(c);if(l)return l;let v=b(h,"subject",c,p),R={...C(v,a,[{kind:"external",id:c}]),createdAt:A(p),recordType:"subject",subjectType:"element",label:c,aliases:[],locators:[{id:b(h,"locator",c,p),kind:"dom_selector",value:c,status:"current",validFrom:A(p),sourceRefs:[{kind:"external",id:c}]}]};return f.push(R),de.set(c,v),v};for(let{key:c,value:p}of S){let l=p.id??c,v=p.createdAt??_,R=b(h,"thread",l,v),k={kind:"thread",id:l},L=[],H=[],ue=Array.isArray(p.messages)?p.messages:[],N,se,me=0;ue.forEach((y,O)=>{let T=y.timestamp??v,B=b(h,"artifact",`${l}:message:${O}`,T);if(L.push(B),x.push({id:B,kind:"message",mediaType:"application/json",location:`.popmelt/threads.json#/threads/${l}/messages/${O}`,availability:"available"}),W.set(`.popmelt/threads.json#/threads/${l}/messages/${O}`,B),y.screenshotPath&&Y(`${l}:message:${O}:screenshot`,"screenshot",y.screenshotPath,T),y.role==="human"){N=y;let E=y.feedbackSummary??y.replyToQuestion;if(E?.trim()){let w=b(h,"observation",`${l}:${O}`,T),U=p.elementIdentifiers??[],te={...C(w,a,[k,{kind:"message",id:B}]),createdAt:A(T),recordType:"observation",state:"open",statement:E,captureContext:{subjectIds:U.map(G=>pe(G,v)),artifactIds:[B]},resolvedByIds:[]};Z(l,te),se=w,H.push({entityType:"observation",entityId:w})}return}if(y.role!=="assistant")return;let V=y.jobId??`${l}:${O}`,F=b(h,"iteration",V,T),J=ce.get(V),je=y.cancelled?"cancelled":y.error?"failed":y.question?"question_asked":(y.resolutions?.length??0)>0?"completed":"no_change",_e={...C(F,s,[k,{kind:"message",id:B},...(ie.get(V)??[]).map(E=>({kind:"artifact",id:E}))]),createdAt:A(T),recordType:"iteration",threadIds:[R],startedAt:A(N?.timestamp,T),completedAt:A(T),requestSummary:he(N?.feedbackSummary,N?.replyToQuestion)??"[legacy request unavailable]",responseSummary:y.question??y.error??y.responseText?.slice(0,1e3),outcome:je,execution:{provider:y.provider??J?.provider,model:y.model??J?.model,sessionId:y.sessionId??J?.sessionId},artifactIds:[B,...ie.get(V)??[]]};Z(l,_e),H.push({entityType:"iteration",entityId:F});let re=y.resolutions??J?.resolutions??[];for(let[E,w]of re.entries()){if(w.status!=="resolved"||!w.summary?.trim())continue;let U=p.elementIdentifiers??[],te=(U.length?U:[i]).map(ge=>({subjectId:ge===i?r:pe(ge,v),role:"governed"})),G=b(h,"proposal",`${V}:${w.annotationId??"resolution"}:${E}`,T),Te={...C(G,s,[k,{kind:"iteration",id:F}]),createdAt:A(T),recordType:"proposal",state:"pending",claim:w.summary,subjects:te,subjectSemantics:te.length>1?"Legacy thread grouped these selected elements; independent scope requires owner review.":void 0,origin:{mode:"inferred",sourceText:he(N?.feedbackSummary,N?.replyToQuestion,w.summary),iterationId:F,inferredById:s}};Z(l,Te),H.push({entityType:"proposal",entityId:G}),e.push({severity:"warning",code:"acceptance_unresolved",source:l,message:`Proposal ${G} remains pending; legacy resolved status proves an outcome, not explicit acceptance.`})}if(re.some(E=>E.status==="resolved")||J?.gitDiff){let E=b(h,"implementation",V,T),w={...C(E,s,[k,{kind:"iteration",id:F}]),createdAt:A(T),recordType:"implementation_attempt",state:"completed",iterationIds:[F],coverageClaims:[],summary:re.map(U=>U.summary).filter(Boolean).join(" ")||"Legacy implementation outcome.",artifactIds:[]};Z(l,w),H.push({entityType:"implementation_attempt",entityId:E}),me+=1}se&&(se=void 0)});let fe=ue.at(-1),$e={...C(R,a,[k]),createdAt:A(v),recordType:"thread",state:fe?.question?"open":"resolved",messageArtifactIds:L,outcome:fe?.question?"question_unresolved":me?"implementation_only":"no_outcome",resultRefs:H};f.push($e),z.set(l,[R,...z.get(l)??[]])}let ee=Ne(j);ee&&e.push({severity:"warning",code:"model_entries_deferred",source:".popmelt/model.json",message:`${ee} model values were not promoted because their accepted decision provenance is unresolved.`});let le={manifest:{formatVersion:1,projectId:t,createdAt:A(_),updatedAt:o,features:["authority","subjects","implementations","eval_specs","portable_artifacts","bounded_retrieval"],writer:{name:"@popmelt.com/core legacy importer",version:n.writerVersion??"0.8.4-dev"}},records:f,events:[],relationships:[],artifacts:x,tombstones:[]},ve=ye(le),be=(n.proofCaseIds??qe).map(c=>({legacyId:c,threadFound:S.some(({key:p,value:l})=>(l.id??p)===c),decisionEnvelopeFound:ce.has(c),recordIds:z.get(c)??[]}));return{bundle:le,report:{projectRoot:i,source:{threads:S.length,messages:S.reduce((c,p)=>c+(p.value.messages?.length??0),0),decisionEnvelopes:M.length,modelEntries:ee,artifactsReferenced:x.length},imported:Oe(f),unresolvedAcceptance:e.filter(c=>c.code==="acceptance_unresolved").length,deferredModelEntries:ee,proofCases:be,issues:e,schemaIssues:ve.issues}}}export{Ve as importLegacyProject,b as legacyUuidV7};