mindgraph 0.15.0 → 0.15.1

package/dist/index.d.mts

@@ -1627,7 +1627,7 @@ interface ProposalEdits {
 }
 interface ProposeOntologySchemaRequest {
     description?: string;
-    template_hint?: "client_services" | "healthcare" | "supply_chain" | "research_intel" | "custom";
+    template_hint?: "client_services" | "healthcare" | "supply_chain" | "research_intel" | "product_intelligence" | "investment_dealflow" | "custom";
     source_uids?: string[];
     source_documents?: Array<{
         content: string;
@@ -1681,8 +1681,14 @@ interface StructuredOntologyQueryRequest {
         offset?: number;
     };
     aggregate?: {
-        op: "count" | "customer_demand_rank";
+        op: "count" | "customer_demand_rank" | "weighted_scorecard";
         group_by?: string;
+        criteria?: Array<{
+            field: string;
+            weight: number;
+            direction: "higher_is_better" | "lower_is_better";
+        }>;
+        missing?: "exclude_candidate" | "zero";
     };
 }
 interface StructuredOntologyQueryResponse {
@@ -1791,9 +1797,28 @@ interface CreateDomainObjectRequest {
     aliases?: string[];
     identity?: Record<string, unknown>;
     confidence?: number;
-    /** Skip the same-type + same-name duplicate guard (default false). */
+    /** Skip the same-type + same-name guard. Schema identity is still enforced. */
     allow_duplicate?: boolean;
 }
+interface UpdateDomainObjectRequest {
+    canonical_name?: string;
+    /** Field patch. Use `unset_fields` rather than null to remove a field. */
+    fields?: Record<string, unknown>;
+    unset_fields?: string[];
+    /** Additive aliases; existing aliases and source provenance are preserved. */
+    aliases?: string[];
+    confidence?: number;
+    /** Optimistic-concurrency guard from the current object's `version`. */
+    expected_version: number;
+    /** Human-readable reason retained in the ontology proposal audit ledger. */
+    reason: string;
+}
+interface DomainObjectMutationResponse {
+    uid: string;
+    proposal_id: string;
+    /** Present on update responses. */
+    version?: number;
+}
 interface ExtractOntologyRequest {
     ontology_schema_id: string;
     source_uids: string[];
@@ -2413,12 +2438,15 @@ declare class MindGraph {
     /**
      * Create a domain object by hand (auto-approved). Returns the created node
      * uid + the audit proposal id. Throws 409 if an object of the same type +
-     * canonical_name already exists, unless `allow_duplicate` is set.
+     * canonical_name already exists, unless `allow_duplicate` is set. The
+     * schema's identity key is always enforced.
      */
-    createDomainObject(req: CreateDomainObjectRequest): Promise<{
-        uid: string;
-        proposal_id: string;
-    }>;
+    createDomainObject(req: CreateDomainObjectRequest): Promise<DomainObjectMutationResponse>;
+    /**
+     * Schema-validated authored update with optimistic concurrency. Identity
+     * fields are immutable; create and explicitly merge when identity changes.
+     */
+    updateDomainObject(uid: string, req: UpdateDomainObjectRequest): Promise<DomainObjectMutationResponse>;
     linkDomainObjects(req: LinkDomainObjectsRequest): Promise<{
         edge_uid: string;
     }>;
@@ -2427,4 +2455,4 @@ declare class MindGraph {
     }>;
 }
 
-export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, type BatchRequest, type BelievedBy, type CanonicalAttachmentAuthority, type CanonicalAttachmentBinding, type CanonicalAttachmentDirection, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, type OntologyToolDescriptor, type OrganizationProps, type Participant, type ParticipantSlotKind, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type ProposalEdits, type PurgeRequest, type RankedClaimHub, type RelatedDomainObjectsRequest, type RelationBacking, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SemanticDependence, type SemanticEvidenceRef, type SemanticEvidenceSourceKind, type SemanticGeneratorRef, type SemanticIdentityMode, type SemanticMatch, type SemanticMatchAlternative, type SemanticMatchStatus, type SemanticModifier, type SemanticModifierMatch, type SemanticNegativeControl, type SemanticParticipantSlot, type SemanticRelationKind, type SemanticReviewDecision, type SemanticRigidity, type SemanticRuntimeTemplate, type SemanticSignal, type SemanticSignalKind, type SemanticTemplateRef, type SemanticTemporalMode, type SemanticTenantBindings, type SemanticValidationAuthoringMode, type SemanticValidationMode, type SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateOntologySchemaRequest };
+export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, type BatchRequest, type BelievedBy, type CanonicalAttachmentAuthority, type CanonicalAttachmentBinding, type CanonicalAttachmentDirection, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, type OntologyToolDescriptor, type OrganizationProps, type Participant, type ParticipantSlotKind, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type ProposalEdits, type PurgeRequest, type RankedClaimHub, type RelatedDomainObjectsRequest, type RelationBacking, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SemanticDependence, type SemanticEvidenceRef, type SemanticEvidenceSourceKind, type SemanticGeneratorRef, type SemanticIdentityMode, type SemanticMatch, type SemanticMatchAlternative, type SemanticMatchStatus, type SemanticModifier, type SemanticModifierMatch, type SemanticNegativeControl, type SemanticParticipantSlot, type SemanticRelationKind, type SemanticReviewDecision, type SemanticRigidity, type SemanticRuntimeTemplate, type SemanticSignal, type SemanticSignalKind, type SemanticTemplateRef, type SemanticTemporalMode, type SemanticTenantBindings, type SemanticValidationAuthoringMode, type SemanticValidationMode, type SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };

package/dist/index.d.ts

@@ -1627,7 +1627,7 @@ interface ProposalEdits {
 }
 interface ProposeOntologySchemaRequest {
     description?: string;
-    template_hint?: "client_services" | "healthcare" | "supply_chain" | "research_intel" | "custom";
+    template_hint?: "client_services" | "healthcare" | "supply_chain" | "research_intel" | "product_intelligence" | "investment_dealflow" | "custom";
     source_uids?: string[];
     source_documents?: Array<{
         content: string;
@@ -1681,8 +1681,14 @@ interface StructuredOntologyQueryRequest {
         offset?: number;
     };
     aggregate?: {
-        op: "count" | "customer_demand_rank";
+        op: "count" | "customer_demand_rank" | "weighted_scorecard";
         group_by?: string;
+        criteria?: Array<{
+            field: string;
+            weight: number;
+            direction: "higher_is_better" | "lower_is_better";
+        }>;
+        missing?: "exclude_candidate" | "zero";
     };
 }
 interface StructuredOntologyQueryResponse {
@@ -1791,9 +1797,28 @@ interface CreateDomainObjectRequest {
     aliases?: string[];
     identity?: Record<string, unknown>;
     confidence?: number;
-    /** Skip the same-type + same-name duplicate guard (default false). */
+    /** Skip the same-type + same-name guard. Schema identity is still enforced. */
     allow_duplicate?: boolean;
 }
+interface UpdateDomainObjectRequest {
+    canonical_name?: string;
+    /** Field patch. Use `unset_fields` rather than null to remove a field. */
+    fields?: Record<string, unknown>;
+    unset_fields?: string[];
+    /** Additive aliases; existing aliases and source provenance are preserved. */
+    aliases?: string[];
+    confidence?: number;
+    /** Optimistic-concurrency guard from the current object's `version`. */
+    expected_version: number;
+    /** Human-readable reason retained in the ontology proposal audit ledger. */
+    reason: string;
+}
+interface DomainObjectMutationResponse {
+    uid: string;
+    proposal_id: string;
+    /** Present on update responses. */
+    version?: number;
+}
 interface ExtractOntologyRequest {
     ontology_schema_id: string;
     source_uids: string[];
@@ -2413,12 +2438,15 @@ declare class MindGraph {
     /**
      * Create a domain object by hand (auto-approved). Returns the created node
      * uid + the audit proposal id. Throws 409 if an object of the same type +
-     * canonical_name already exists, unless `allow_duplicate` is set.
+     * canonical_name already exists, unless `allow_duplicate` is set. The
+     * schema's identity key is always enforced.
      */
-    createDomainObject(req: CreateDomainObjectRequest): Promise<{
-        uid: string;
-        proposal_id: string;
-    }>;
+    createDomainObject(req: CreateDomainObjectRequest): Promise<DomainObjectMutationResponse>;
+    /**
+     * Schema-validated authored update with optimistic concurrency. Identity
+     * fields are immutable; create and explicitly merge when identity changes.
+     */
+    updateDomainObject(uid: string, req: UpdateDomainObjectRequest): Promise<DomainObjectMutationResponse>;
     linkDomainObjects(req: LinkDomainObjectsRequest): Promise<{
         edge_uid: string;
     }>;
@@ -2427,4 +2455,4 @@ declare class MindGraph {
     }>;
 }
 
-export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, type BatchRequest, type BelievedBy, type CanonicalAttachmentAuthority, type CanonicalAttachmentBinding, type CanonicalAttachmentDirection, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, type OntologyToolDescriptor, type OrganizationProps, type Participant, type ParticipantSlotKind, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type ProposalEdits, type PurgeRequest, type RankedClaimHub, type RelatedDomainObjectsRequest, type RelationBacking, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SemanticDependence, type SemanticEvidenceRef, type SemanticEvidenceSourceKind, type SemanticGeneratorRef, type SemanticIdentityMode, type SemanticMatch, type SemanticMatchAlternative, type SemanticMatchStatus, type SemanticModifier, type SemanticModifierMatch, type SemanticNegativeControl, type SemanticParticipantSlot, type SemanticRelationKind, type SemanticReviewDecision, type SemanticRigidity, type SemanticRuntimeTemplate, type SemanticSignal, type SemanticSignalKind, type SemanticTemplateRef, type SemanticTemporalMode, type SemanticTenantBindings, type SemanticValidationAuthoringMode, type SemanticValidationMode, type SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateOntologySchemaRequest };
+export { type AggregatePoint, type AnalogyCandidate, type AppendSeriesResponse, type ArgumentRequest, type ArticleResult, type BatchAggregateSeriesResponse, type BatchLatestSeriesResponse, type BatchRequest, type BelievedBy, type CanonicalAttachmentAuthority, type CanonicalAttachmentBinding, type CanonicalAttachmentDirection, type CaptureRequest, type ClaimHub, type ClearResponse, type ClusterClaimSample, type ClusteredClaimHub, type CommitmentRequest, type ConceptCluster, type CreateDomainObjectRequest, type CreateOntologySchemaRequest, type CreateSeriesResponse, type DecayRequest, type DeleteSeriesResponse, type DeliberationRequest, type DialecticalPair, type DistillRequest, type DocumentRef, type DomainObject, type DomainObjectMutationResponse, type EnrichedSearchResponse, type EntityBridge, type EntityRequest, type EpistemicCounts, type EventProps, type EvolveRequest, type ExecutionRequest, type FieldDefinition, type FieldSemantic, type FieldSemanticKind, type FiscalYearEnd, type GovernanceRequest, type GovernanceTarget, type GraphEdge, type GraphNode, type IngestChunkRequest, type IngestChunkResponse, type IngestDocumentRequest, type IngestDocumentResponse, type IngestSessionRequest, type InquiryRequest, type Job, type ListArticlesResponse, type ListSeriesResponse, type MeasurementPoint, type MemoryConfigRequest, type MemorySyncRequest, MindGraph, type MindGraphConfig, MindGraphError, type NationProps, type NormativeKind, type ObjectBacking, type OntologicalBaseKind, type OntologyDuplicateAudit, type OntologyObjectType, type OntologyObjectTypeInput, type OntologyPredicateOperator, type OntologyProposal, type OntologyQueryPredicate, type OntologyRelationType, type OntologyRelationTypeInput, type OntologySchema, type OntologySchemaDetail, type OntologySeriesBinding, type OntologyToolDescriptor, type OrganizationProps, type Participant, type ParticipantSlotKind, type PathStep, type PersonProps, type PlaceProps, type PlanRequest, type ProcedureRequest, type ProposalEdits, type PurgeRequest, type RankedClaimHub, type RelatedDomainObjectsRequest, type RelationBacking, type RetrieveContextRequest, type RetrieveContextResponse, type RetrieveRequest, type RiskRequest, type SearchChunk, type SearchResult, type SemanticDependence, type SemanticEvidenceRef, type SemanticEvidenceSourceKind, type SemanticGeneratorRef, type SemanticIdentityMode, type SemanticMatch, type SemanticMatchAlternative, type SemanticMatchStatus, type SemanticModifier, type SemanticModifierMatch, type SemanticNegativeControl, type SemanticParticipantSlot, type SemanticRelationKind, type SemanticReviewDecision, type SemanticRigidity, type SemanticRuntimeTemplate, type SemanticSignal, type SemanticSignalKind, type SemanticTemplateRef, type SemanticTemporalMode, type SemanticTenantBindings, type SemanticValidationAuthoringMode, type SemanticValidationMode, type SeriesAggregateResponse, type SeriesBacking, type SeriesContextAnnotation, type SeriesLatestResponse, type SeriesNode, type SeriesProps, type SeriesRequest, type SeriesWindowResponse, type SessionRequest, type SignalsQuery, type SignalsResponse, type SkillDistillProps, type SkillDistillRequest, type SourceChunk, type StructureRequest, type StructuredOntologyQueryRequest, type StructuredOntologyQueryResponse, type SynthesisJobResponse, type TextSelector, type TheorySupportGap, type TraverseRequest, type UpdateDomainObjectRequest, type UpdateOntologySchemaRequest };

package/dist/index.js

@@ -949,11 +949,19 @@ var MindGraph = class {
   /**
    * Create a domain object by hand (auto-approved). Returns the created node
    * uid + the audit proposal id. Throws 409 if an object of the same type +
-   * canonical_name already exists, unless `allow_duplicate` is set.
+   * canonical_name already exists, unless `allow_duplicate` is set. The
+   * schema's identity key is always enforced.
    */
   async createDomainObject(req) {
     return this.post("/v1/ontology/objects", req);
   }
+  /**
+   * Schema-validated authored update with optimistic concurrency. Identity
+   * fields are immutable; create and explicitly merge when identity changes.
+   */
+  async updateDomainObject(uid, req) {
+    return this.patch(`/v1/ontology/objects/${seg(uid)}`, req);
+  }
   async linkDomainObjects(req) {
     return this.post("/ontology/relation", { action: "create", ...req });
   }

package/dist/index.mjs

@@ -922,11 +922,19 @@ var MindGraph = class {
   /**
    * Create a domain object by hand (auto-approved). Returns the created node
    * uid + the audit proposal id. Throws 409 if an object of the same type +
-   * canonical_name already exists, unless `allow_duplicate` is set.
+   * canonical_name already exists, unless `allow_duplicate` is set. The
+   * schema's identity key is always enforced.
    */
   async createDomainObject(req) {
     return this.post("/v1/ontology/objects", req);
   }
+  /**
+   * Schema-validated authored update with optimistic concurrency. Identity
+   * fields are immutable; create and explicitly merge when identity changes.
+   */
+  async updateDomainObject(uid, req) {
+    return this.patch(`/v1/ontology/objects/${seg(uid)}`, req);
+  }
   async linkDomainObjects(req) {
     return this.post("/ontology/relation", { action: "create", ...req });
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindgraph",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "TypeScript client for the MindGraph Cloud API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",