@cgh567/agent 2.4.2 → 2.4.3

package/daemon/schema-definitions.js

@@ -0,0 +1,423 @@
+'use strict';
+/**
+ * schema-definitions.js — Declarative Memgraph schema for the Helios daemon.
+ *
+ * This is the single source of truth for every index and uniqueness constraint
+ * in the graph. It replaces the seven legacy migration files (schema-migrations*.js)
+ * which accumulated duplicates, syntax inconsistencies, and uncovered labels.
+ *
+ * Applied via schema-apply.js using Memgraph's MAGE schema.assert() procedure,
+ * which converges the live graph to exactly this definition on every startup:
+ *   • Creates anything missing
+ *   • Keeps anything already correct
+ *   • Logs every action (Created / Kept / Dropped) for auditability
+ *
+ * ── Index map format ──────────────────────────────────────────────────────────
+ * indexes: { Label: ['prop1', 'prop2', ...] }
+ *   Empty string '' → label-only index (fastest for existence checks)
+ *   Single string   → label+property index
+ *   Strings in the same array are individual single-property indexes on that label.
+ *   Composite indexes (multiple props together) go in compositeIndexes.
+ *
+ * ── Unique constraint format ──────────────────────────────────────────────────
+ * uniqueConstraints: { Label: [['prop'], ['propA', 'propB'], ...] }
+ *   Each inner array is one unique constraint.
+ *   Single-element → standard unique on one property.
+ *   Multi-element  → composite unique constraint.
+ *
+ * ── Notes ─────────────────────────────────────────────────────────────────────
+ * schema.assert() takes (indices_map, unique_constraints, existence_constraints, drop_existing).
+ * For indices_map each label maps to a list; '' = label-only, 'prop' = label+property.
+ * For unique_constraints each label maps to a list-of-lists for composite support.
+ */
+
+// ── Indexes ───────────────────────────────────────────────────────────────────
+// Each key is a node label.
+// Each value is an array of property names to index individually on that label.
+// Use '' (empty string) to create a label-only index alongside property indexes.
+
+const INDEXES = {
+
+  // ── Core task / agent ──────────────────────────────────────────────────────
+  Task: [
+    'companyId', 'status', 'assigneeAgentId', 'checkoutRunId', 'workspaceId',
+    'originKind', 'hboTaskId', 'hboGoalId', 'outputConfidence',
+    'cascade_exempt', 'startedAt', 'completedAt', 'andoning',
+    'workType', 'workCategory', 'pdsaProcessed', 'progressPropagated', 'taskType',
+    'pillarId',  // set by pillar-dispatcher.js; used by PDSACycle pillar lookup
+  ],
+  BusinessAgent: [
+    'companyId', 'role', 'status', 'adapterType', 'pendingApprovalId', 'agentKey',
+  ],
+  Comment:       ['taskId', 'authorType'],
+  Workspace:     ['agentId', 'runId'],
+  Transcript:    ['runId', 'agentId'],
+
+  // ── Scheduling / routines ──────────────────────────────────────────────────
+  Routine:         ['companyId', 'agentId', 'status', 'nextRunAt', 'latestRevisionId'],
+  RoutineTrigger:  ['routineId', 'publicId'],
+  RoutineRevision: ['routineId'],
+  RoutineRun:      ['routineId', 'linkedTaskId'],
+  Heartbeat:       ['agentId', 'status', 'scheduledAt'],
+  SchedulerState:  ['companyId'],
+
+  // ── Approvals / actions ────────────────────────────────────────────────────
+  Approval:       ['companyId', 'status', 'type', 'requestedBy', 'pillarId'],
+  HeartbeatRun:   ['agentId', 'taskId', 'status', 'companyId'],
+
+  // ── HBO goal hierarchy ─────────────────────────────────────────────────────
+  CompanyGoal:    ['companyId', 'status', 'ownerAgentId'],
+  BusinessGoal:   ['companyId', 'status', 'parentGoalId', 'createdAt'],
+  GoalNode:       ['companyId', 'status'],
+
+  // ── Hoshin Kanri cascade ───────────────────────────────────────────────────
+  GoalPillar: [
+    'companyId', 'goalId', 'openWindowRate', 'consecutiveZeroWeeks',
+    'department', 'l2ReviewStatus', 'assignedRole', 'l2ReviewCycles',
+  ],
+  ActionCell: [
+    'pillarId', 'goalId', 'companyId', 'status', 'assigneeAgentId',
+    'l3ReviewStatus', 'l3ReviewCycles',
+  ],
+  GoalResearchBrief:    ['companyId', 'expiresAt'],
+  StandardWorkDocument: ['companyId', 'agentId', 'taskOriginKind', 'version'],
+  StandardWorkDeviation: [
+    'taskId', 'agentId', 'standardWorkId', 'status', 'detectedAt',
+  ],
+  OKRSeed:              ['companyId', 'goalId'],
+
+  // ── Project intelligence ───────────────────────────────────────────────────
+  HeliosProject:        ['companyId', 'pillarId', 'status', 'createdAt'],
+  ProjectDocument:      ['projectId', 'updatedAt', 'companyId'],  // companyId gap filled
+  ProjectQuestion:      ['projectId', 'status'],
+  DocumentEdit:         ['documentId', 'createdAt', 'companyId'], // companyId gap filled
+  PendingDocumentUpdate:['documentId', 'status', 'createdAt'],
+  DepartmentPage:       ['companyId', 'department', 'lastGeneratedAt'],
+  PlanChangeProposal:   ['companyId', 'targetId', 'status', 'scope', 'createdAt'],
+
+  // ── Company beliefs (previously missing entirely) ──────────────────────────
+  CompanyBelief: [
+    'companyId', 'department', 'templateKey', 'isConfirmed',
+  ],
+  BeliefObservation: ['companyId', 'beliefId'],
+  BudgetPolicy:      ['companyId'],  // high-frequency budget enforcement queries
+
+  // ── Anomaly / signals ──────────────────────────────────────────────────────
+  AnomalySignal: [
+    'companyId', 'agentId', 'taskId', 'tier', 'signalType',
+    'severity', 'status', 'detectedAt', 'source',
+  ],
+  AndonAlert:       ['companyId', 'agentId', 'resolvedAt'],
+  AndonSignal:      ['companyId'],   // legacy label — kept until re-label migration clears it
+  RecurringPattern: ['companyId', 'signalType', 'agentId', 'status'],
+  KaizenProposal:   ['companyId', 'status', 'ownerAgentId', 'sourceType'],
+  CascadeReviewAlert: ['companyId', 'agentId', 'actioned', 'triggeredAt'],
+
+  // ── PDSA / learning ───────────────────────────────────────────────────────
+  PDSACycle:     ['companyId', 'taskId', 'agentId', 'actDecision', 'pillarId'],
+  KnowledgeAsset:['companyId', 'status', 'confidence', 'lastAppliedAt', 'applicableTaskTypes'],
+  HanseiRecord:  ['companyId', 'taskId', 'agentId'],
+
+  // ── OKRs / cascade integrity ───────────────────────────────────────────────
+  QuarterlyOKR: [
+    'companyId', 'status', 'quarter', 'assigneeAgentId', 'catchballStatus', 'grade',
+  ],
+  OKRFeedback:         ['okrId', 'fromAgentId', 'status'],
+  ObstacleRecord:      ['companyId', 'linkedOKRId', 'agentId', 'status'],
+  CatchballDisagreement: ['okrId', 'fromAgentId', 'objectionType'],
+  BeliefCeilingAssessment: ['okrId', 'agentId'],
+  SacrificeDeclaration:    ['agentId', 'okrId', 'sacrificeVerified'],
+  PersonalCascade:         ['companyId', 'agentId', 'integrityScore'],
+  CascadeIntegrityScore:   ['companyId', 'agentId', 'calculatedAt', 'overallScore'],
+  SelfProposedOKR:         ['companyId', 'agentId', 'status', 'selfAnalysisId'],
+  GoalDecompositionDraft:  ['companyId', 'agentId', 'sourceAnalysisId'],
+
+  // ── Agent capability / coaching ───────────────────────────────────────────
+  CapabilityProfile:   ['companyId', 'agentId', 'overallScore'],
+  CapabilityGap:       ['companyId', 'agentId', 'dimension', 'status'],
+  FutureStateCommitment: ['companyId', 'agentId', 'gapClosureRate'],
+  EmpiricalCapabilityAssessment: ['companyId', 'agentId'],
+  AgentSelfAnalysis:   ['companyId', 'agentId', 'triggerType', 'isComplete'],
+  AgentCollabRequest:  ['companyId', 'fromAgentId', 'toAgentId', 'status'],
+  CoachingContract:    ['companyId', 'agentId', 'coachAgentId', 'status'],
+  KataCoachingSession: ['companyId', 'agentId', 'weekOf', 'sessionStatus'],
+  MirrorObservation:   ['companyId', 'agentId', 'patternType', 'status'],
+  PatternResponse:     ['mirrorObservationId', 'agentId'],
+  MasteryMoment:       ['companyId', 'agentId', 'okrId', 'status'],
+  MasteryReflection:   ['masteryMomentId', 'agentId', 'specificityScore'],
+  MasteryTimeline:     ['companyId', 'agentId'],
+  CharacterDimensionProfile: ['agentId'],
+  WeeklyReview:        ['companyId', 'weekOf'],
+  DailyRoutineCard:    ['companyId', 'agentId', 'date'],
+
+  // ── Agent mastery ──────────────────────────────────────────────────────────
+  MonthlyPredictionValidation: ['companyId', 'agentId', 'month'],
+
+  // ── Cost & budget ──────────────────────────────────────────────────────────
+  CostEvent:       ['companyId', 'agentId', 'createdAt', 'model', 'biller'],
+  BusinessCostEvent: ['companyId', 'agentId', 'createdAt', 'businessTaskId'],
+  BudgetIncident:  ['companyId', 'status', 'policyId'],
+  ActivityEvent:   ['companyId', 'action', 'createdAt'],
+  TaskEnrichment:  ['companyId', 'taskId', 'createdAt', 'workType', 'originKind'],
+
+  // ── CRM / outreach ────────────────────────────────────────────────────────
+  Lead:         ['companyId', 'status', 'score', 'personId', 'businessId'],
+  Opportunity:  ['companyId', 'stage', 'accountId', 'ownerId'],
+  Account:      ['companyId', 'domain'],
+  Contact:      ['companyId', 'accountId', 'email'],
+  ICPScore:     ['companyId', 'accountId'],
+  Signal:       ['companyId', 'type', 'accountId', 'createdAt'],
+  Sequence:     ['companyId', 'status'],
+  Campaign:     ['companyId', 'status'],
+  Deal:         ['companyId', 'stage', 'ownerId'],
+  BusinessTask: ['companyId', 'status', 'assigneeId', 'goalId', 'dueDate', 'createdAt'],
+  CRMContact:   ['companyId', 'personId', 'email', 'dunbarLayer', 'needsFollowUp'],
+  ActiveSequence: ['companyId', 'status'],
+
+  // ── People / social graph ─────────────────────────────────────────────────
+  Person:       ['dunbarLayer', 'name', 'healthStatus', 'relationshipStrength', 'communityId'],
+  Identity:     ['handle', 'platform'],
+  Organization: ['name', 'domain'],
+  FAVEESnapshot: ['personId', 'week'],
+  Conversation:  ['platform', 'threadId'],
+  Episode:       ['rawId', 'receivedAt', 'platform', 'sessionId'],
+  Topic:         ['status', 'name'],
+  Question:      ['status'],
+  Commitment:    ['status', 'dueDate'],
+
+  // ── Email / triage ────────────────────────────────────────────────────────
+  Email:             ['processedAt', 'address', 'triagePriority'],
+  EmailTriageResult: ['processedAt'],
+  TriageDecision:    ['userOverride'],
+
+  // ── Auth / session (Harada) ───────────────────────────────────────────────
+  User:      ['email', 'createdAt'],
+  Session:   ['userId', 'expiresAt', 'createdAt'],
+  HaradaMap: ['userId', 'createdAt', 'updatedAt'],
+
+  // ── Strategy / OKR ───────────────────────────────────────────────────────
+  Strategy:      ['companyId', 'goalId'],
+  SystemAim:     ['companyId', 'industry'],
+  Department:    ['companyId'],   // gap filled — missing companyId index
+
+  // ── Domain config ─────────────────────────────────────────────────────────
+  CompanySkillConfig: ['domain'],
+  PillarRoutingConfig: ['companyId'],
+  SkillDef:    ['name', 'contentHash'],
+  CompanySkill: ['key'],
+  // KnowledgeAsset indexes defined earlier (line ~117) with full property list
+
+  // ── HITL / interaction loop ───────────────────────────────────────────────
+  HITLInteraction: [
+    'companyId', 'taskId', 'agentId', 'status', 'kind',
+    'batchId', 'idempotencyKey', 'createdAt', 'resolvedAt', 'continuationPolicy',
+  ],
+  HITLQuestion: ['interactionId', 'companyId', 'kind'],
+  HITLAnswer:   ['interactionId', 'companyId', 'createdAt'],
+  AgentReadySignal: ['companyId', 'agentId', 'status', 'createdAt', 'sourceType'],
+
+  // ── HED (Helios Engineering Daemon) ──────────────────────────────────────
+  HEDOperation:      ['hedId', 'status', 'wave', 'assignedAgentRole'],
+  HEDReviewFinding:  ['opId', 'verdict'],
+  BlastRadiusEvent:  ['opId', 'severity'],
+
+  // ── Misc (previously uncovered — gaps filled) ────────────────────────────
+  Hansei:           ['agentId'],       // written via MERGE in routes/sensei.js
+  ApprovalComment:  ['taskId', 'approvalId'],  // written via CREATE
+  ProcessMetric:    ['companyId', 'agentId', 'metricName'],
+  ControlChartSignal: ['metricId', 'agentId', 'status'],
+
+  // ── Outreach / property / realty ─────────────────────────────────────────
+  Outreach: ['sentAt', 'replied'],
+  Property: ['name', 'city'],
+  ManagementCompany: ['name', 'domain', 'lifecycleStage', 'icpTier'],
+};
+
+// ── Composite indexes (multi-property together) ───────────────────────────────
+// schema.assert() handles single-property indexes via the INDEXES map above.
+// Composite indexes must be created via separate Cypher statements because
+// schema.assert() only creates single-property label indexes.
+// These are applied in schema-apply.js via direct mgQuery calls.
+
+const COMPOSITE_INDEXES = [
+  { label: 'Task',             props: ['companyId', 'status'] },
+  { label: 'KnowledgeAsset',   props: ['companyId', 'status'] },
+  { label: 'CompanySkill',     props: ['companyId', 'key'] },
+  { label: 'PillarRoutingConfig', props: ['companyId', 'pillarName'] },
+  { label: 'HITLInteraction',  props: ['taskId', 'status'] },
+  { label: 'HITLInteraction',  props: ['companyId', 'status'] },
+  { label: 'HITLInteraction',  props: ['companyId', 'idempotencyKey'] },
+  { label: 'HITLInteraction',  props: ['companyId', 'kind', 'status'] },
+  { label: 'AgentReadySignal', props: ['agentId', 'status', 'sourceType'] },
+  // M6: Approval queries in decisions timeline and approvals list both filter by companyId+pillarId
+  // and companyId+status respectively. Single-prop indexes require sequential scans at scale.
+  { label: 'Approval',         props: ['companyId', 'pillarId'] },
+  { label: 'Approval',         props: ['companyId', 'status'] },
+  // PDSACycle decisions timeline filters by companyId+pillarId
+  { label: 'PDSACycle',        props: ['companyId', 'pillarId'] },
+];
+
+// ── Unique constraints ────────────────────────────────────────────────────────
+// schema.assert() takes a map of label → list-of-lists.
+// Each inner array is one unique constraint (single or composite properties).
+
+const UNIQUE_CONSTRAINTS = {
+  // ── Core ──────────────────────────────────────────────────────────────────
+  Task:             [['id']],
+  Comment:          [['id']],
+  Workspace:        [['id']],
+  Transcript:       [['id']],
+  Routine:          [['id']],
+  RoutineTrigger:   [['id']],
+  RoutineRevision:  [['id']],
+  RoutineRun:       [['id']],
+  Approval:         [['id']],
+  HeartbeatRun:     [['id']],
+  Heartbeat:        [['id']],
+  ActivityEvent:    [['id']],
+  CostEvent:        [['id']],
+  BudgetIncident:   [['id']],
+  AndonAlert:       [['id']],
+
+  // ── HBO goal hierarchy ────────────────────────────────────────────────────
+  Company:          [['id']],
+  BusinessAgent:    [['id']],
+  Department:       [['id']],
+  CompanyGoal:      [['id']],
+  BusinessGoal:     [['id']],
+  BusinessTask:     [['id']],
+  BusinessCostEvent:[['id']],
+  GoalNode:         [['id']],
+
+  // ── Hoshin / cascade ──────────────────────────────────────────────────────
+  GoalPillar:           [['id']],
+  ActionCell:           [['id']],
+  GoalResearchBrief:    [['id']],
+  StandardWorkDocument: [['id']],
+  StandardWorkDeviation:[['id']],
+  OKRSeed:              [['id']],
+
+  // ── Project intelligence ──────────────────────────────────────────────────
+  HeliosProject:         [['id']],
+  ProjectDocument:       [['id']],
+  ProjectQuestion:       [['id']],
+  DocumentEdit:          [['id']],
+  PendingDocumentUpdate: [['id']],
+  DepartmentPage:        [['id']],
+  PlanChangeProposal:    [['id']],
+
+  // ── Company beliefs (previously missing entirely) ─────────────────────────
+  CompanyBelief:    [['id']],  // CRITICAL: concurrent MERGE safety
+  BeliefObservation:[['id']],  // CRITICAL: concurrent MERGE safety
+  BudgetPolicy:     [['id']],  // CRITICAL: budget enforcement + MERGE safety
+
+  // ── Anomaly / signals ─────────────────────────────────────────────────────
+  AnomalySignal:    [['id']],
+  AndonSignal:      [['id']],  // legacy label — keep until re-label migration clears
+  RecurringPattern: [['id']],
+  KaizenProposal:   [['id']],
+  CascadeReviewAlert:[['id']],
+
+  // ── PDSA / learning ───────────────────────────────────────────────────────
+  PDSACycle:      [['id']],
+  KnowledgeAsset: [['id']],
+  HanseiRecord:   [['id']],
+  Hansei:         [['id']],    // previously missing — written via MERGE
+
+  // ── OKRs ──────────────────────────────────────────────────────────────────
+  QuarterlyOKR:    [['id']],
+  OKRFeedback:     [['id']],
+  ObstacleRecord:  [['id']],
+  CatchballDisagreement:      [['id']],
+  BeliefCeilingAssessment:    [['id']],
+  SacrificeDeclaration:       [['id']],
+  PersonalCascade:            [['id']],
+  CascadeIntegrityScore:      [['id']],
+  SelfProposedOKR:            [['id']],
+  GoalDecompositionDraft:     [['id']],
+
+  // ── Agent capability ──────────────────────────────────────────────────────
+  CapabilityProfile:    [['id']],
+  CapabilityGap:        [['id']],
+  FutureStateCommitment:[['id']],
+  EmpiricalCapabilityAssessment:[['id']],
+  AgentSelfAnalysis:    [['id']],
+  AgentCollabRequest:   [['id']],
+  CoachingContract:     [['id']],
+  KataCoachingSession:  [['id']],
+  MirrorObservation:    [['id']],
+  PatternResponse:      [['id']],
+  MasteryMoment:        [['id']],
+  MasteryReflection:    [['id']],
+  MasteryTimeline:      [['id']],
+  CharacterDimensionProfile:[['id']],
+  WeeklyReview:         [['id']],
+  DailyRoutineCard:     [['id']],
+  MonthlyPredictionValidation:[['id']],
+
+  // ── Cost ──────────────────────────────────────────────────────────────────
+  TaskEnrichment:    [['id']],
+  SchedulerState:    [['id']],
+
+  // ── CRM / outreach ────────────────────────────────────────────────────────
+  Lead:         [['id']],
+  Opportunity:  [['id']],
+  Account:      [['id']],
+  Contact:      [['id']],
+  ICPScore:     [['id']],
+  Signal:       [['id']],
+  Sequence:     [['id']],
+  Campaign:     [['id']],
+  Deal:         [['id']],
+  CRMContact:   [['id']],
+  Person:       [['id']],
+  Identity:     [['id']],
+  Organization: [['id']],
+
+  // ── People / social ───────────────────────────────────────────────────────
+  FAVEESnapshot: [['id']],
+  Conversation:  [['id']],
+  Episode:       [['id']],
+  Topic:         [['id']],
+  Question:      [['id']],
+  Commitment:    [['id']],
+  Business:      [['id']],
+  Property:      [['id']],
+  ManagementCompany:[['id']],
+  ParentCompany: [['id']],
+  Outreach:      [['id']],
+
+  // ── Strategy ──────────────────────────────────────────────────────────────
+  Strategy:      [['id']],
+  SystemAim:     [['id']],
+
+  // ── Auth / session ────────────────────────────────────────────────────────
+  User:      [['id']],
+  Session:   [['id'], ['token']],  // two constraints: id AND token
+  HaradaMap: [['id']],
+
+  // ── Domain config — NON-ID unique constraints ─────────────────────────────
+  CompanySkillConfig:  [['companyId']],               // unique per company, not per id
+  PillarRoutingConfig: [['companyId', 'pillarName']],  // composite unique
+  SkillDef:            [['id']],
+
+  // ── HITL ──────────────────────────────────────────────────────────────────
+  HITLInteraction: [['id']],
+  HITLQuestion:    [['id']],
+  HITLAnswer:      [['id']],
+  AgentReadySignal:[['id']],
+
+  // ── HED ───────────────────────────────────────────────────────────────────
+  HEDOperation:     [['id']],
+  HEDReviewFinding: [['id']],
+  BlastRadiusEvent: [['id']],
+
+  // ── SyncCursor — keyed on .name, not .id ─────────────────────────────────
+  SyncCursor: [['name']],  // previously missing; MERGE'd on .name
+
+  // ── Process metrics ───────────────────────────────────────────────────────
+  ProcessMetric:      [['id']],
+  ControlChartSignal: [['id']],
+};
+
+module.exports = { INDEXES, COMPOSITE_INDEXES, UNIQUE_CONSTRAINTS };

package/daemon/schema-migrations-hbo.js

@@ -574,6 +574,16 @@ async function runHBOMigrations(mgQuery) {
     `CREATE CONSTRAINT FOR (n:ServiceAccount) REQUIRE n.id IS UNIQUE`,
     `CREATE INDEX FOR (n:ServiceAccount) ON (n.agentId, n.status)`,
     `CREATE INDEX FOR (n:ServiceAccount) ON (n.service, n.status)`,
+
+    // ── P4-03: executionStateJson backfill ────────────────────────────────────
+    // All existing Task nodes must have executionStateJson set to the string 'null'
+    // (not Cypher null) so the P4-04 CONTAINS check works correctly.
+    // A Cypher null property means the CONTAINS string operator would throw.
+    // Idempotent: WHERE clause skips nodes that already have the field.
+    // DEPLOYMENT NOTE: This daemon instance manages a single Memgraph tenant.
+    // The unscoped MATCH (t:Task) is intentional — all Task nodes in this Memgraph
+    // instance belong to the companies managed by this daemon.
+    `MATCH (t:Task) WHERE t.executionStateJson IS NULL SET t.executionStateJson = 'null'`,
   ];
 
   let successCount = 0;

package/daemon/schema-migrations-hed.js

@@ -0,0 +1,18 @@
+'use strict';
+/**
+ * schema-migrations-hed.js — HED (Helios Event Dispatch) schema migrations.
+ * Stub implementation — full migrations run when Memgraph is available.
+ */
+
+async function runHedMigrations(mgQuery) {
+  // HED schema migrations — no-op when Memgraph is unavailable
+  try {
+    await mgQuery(`CREATE INDEX IF NOT EXISTS ON :HEDEvent(companyId)`, {});
+    await mgQuery(`CREATE INDEX IF NOT EXISTS ON :HEDEvent(sessionId)`, {});
+    await mgQuery(`CREATE INDEX IF NOT EXISTS ON :HEDEvent(createdAt)`, {});
+  } catch (_) {
+    // Fail-open: Memgraph unavailable — skip HED migrations
+  }
+}
+
+module.exports = { runHedMigrations };

package/daemon/schema-migrations-proj.js

@@ -0,0 +1,131 @@
+'use strict';
+const { randomUUID } = require('crypto');
+
+async function runProjectMigrations(mgQuery) {
+  const migrations = [
+    // ── SM-proj-01: HeliosProject node ──────────────────────────────────────
+    `CREATE CONSTRAINT FOR (n:HeliosProject) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:HeliosProject) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:HeliosProject) ON (n.pillarId)`,
+    `CREATE INDEX FOR (n:HeliosProject) ON (n.status)`,
+    `CREATE INDEX FOR (n:HeliosProject) ON (n.createdAt)`,
+
+    // ── SM-proj-02: ProjectDocument node ────────────────────────────────────
+    `CREATE CONSTRAINT FOR (n:ProjectDocument) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:ProjectDocument) ON (n.projectId)`,
+    `CREATE INDEX FOR (n:ProjectDocument) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:ProjectDocument) ON (n.updatedAt)`,
+
+    // ── SM-proj-03: ProjectQuestion node ────────────────────────────────────
+    `CREATE CONSTRAINT FOR (n:ProjectQuestion) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:ProjectQuestion) ON (n.projectId)`,
+    `CREATE INDEX FOR (n:ProjectQuestion) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:ProjectQuestion) ON (n.status)`,
+    `CREATE INDEX FOR (n:ProjectQuestion) ON (n.createdAt)`,
+
+    // ── SM-proj-04: DocumentEdit node ────────────────────────────────────────
+    `CREATE CONSTRAINT FOR (n:DocumentEdit) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:DocumentEdit) ON (n.documentId)`,
+    `CREATE INDEX FOR (n:DocumentEdit) ON (n.projectId)`,
+    `CREATE INDEX FOR (n:DocumentEdit) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:DocumentEdit) ON (n.editedAt)`,
+
+    // ── SM-proj-05: PendingDocumentUpdate node ──────────────────────────────
+    `CREATE CONSTRAINT FOR (n:PendingDocumentUpdate) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:PendingDocumentUpdate) ON (n.documentId)`,
+    `CREATE INDEX FOR (n:PendingDocumentUpdate) ON (n.projectId)`,
+    `CREATE INDEX FOR (n:PendingDocumentUpdate) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:PendingDocumentUpdate) ON (n.status)`,
+
+    // ── SM-proj-06: Additions to existing nodes ──────────────────────────────
+    `CREATE INDEX FOR (n:Task) ON (n.projectId)`,
+    `CREATE INDEX FOR (n:AnomalySignal) ON (n.projectId)`,
+
+    // -- SM-proj-07: DepartmentPage node ------------------------------------------
+    `CREATE CONSTRAINT FOR (n:DepartmentPage) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.department)`,
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.generatedAt)`,
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.status)`,
+
+    // SM-proj-08: GoalPillar absorbs HeliosProject properties -- new indexes
+    `CREATE INDEX FOR (n:GoalPillar) ON (n.projectStatus)`,
+    `CREATE INDEX FOR (n:GoalPillar) ON (n.driAgentId)`,
+    `CREATE INDEX FOR (n:GoalPillar) ON (n.currentPhaseLabel)`,
+
+    // SM-proj-09: DeptLearning node type for department page institutional memory
+    `CREATE CONSTRAINT FOR (n:DeptLearning) REQUIRE n.id IS UNIQUE`,
+    `CREATE INDEX FOR (n:DeptLearning) ON (n.companyId)`,
+    `CREATE INDEX FOR (n:DeptLearning) ON (n.department)`,
+    `CREATE INDEX FOR (n:DeptLearning) ON (n.capturedAt)`,
+
+    // SM-proj-10: DepartmentPage enhanced fields indexes
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.exceptionLevel)`,
+    `CREATE INDEX FOR (n:DepartmentPage) ON (n.version)`,
+  ];
+
+  let success = 0, skipped = 0, failed = 0;
+  for (const cypher of migrations) {
+    try {
+      await mgQuery(cypher, {});
+      success++;
+    } catch (err) {
+      const msg = (err.message || '').toLowerCase();
+      if (msg.includes('already exists') || msg.includes('constraint already exists') ||
+          msg.includes('index already exists')) {
+        skipped++;
+      } else {
+        console.error('[schema-migrations-proj] Migration failed:', cypher.slice(0, 80), err.message);
+        failed++;
+      }
+    }
+  }
+  console.log(`[schema-migrations-proj] done — success:${success} skipped:${skipped} failed:${failed}`);
+  await runIntelligenceNodeMigrations(mgQuery);
+}
+
+
+// SM-proj-08 — Financial + CS + Marketing + Ops node schemas
+async function runIntelligenceNodeMigrations(mgQuery) {
+  const migrations = [
+    // Finance nodes
+    "CREATE CONSTRAINT fin_snapshot_id IF NOT EXISTS FOR (n:FinancialSnapshot) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX fin_snapshot_cid IF NOT EXISTS FOR (n:FinancialSnapshot) ON (n.companyId)",
+    "CREATE CONSTRAINT burn_mult_id IF NOT EXISTS FOR (n:BurnMultipleCalc) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX burn_mult_cid IF NOT EXISTS FOR (n:BurnMultipleCalc) ON (n.companyId)",
+    "CREATE CONSTRAINT nrr_calc_id IF NOT EXISTS FOR (n:NRRCalc) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX nrr_calc_cid IF NOT EXISTS FOR (n:NRRCalc) ON (n.companyId)",
+    "CREATE CONSTRAINT gross_margin_id IF NOT EXISTS FOR (n:GrossMarginTimeSeries) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX gross_margin_cid IF NOT EXISTS FOR (n:GrossMarginTimeSeries) ON (n.companyId)",
+    "CREATE CONSTRAINT headcount_id IF NOT EXISTS FOR (n:HeadcountPlan) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX headcount_cid IF NOT EXISTS FOR (n:HeadcountPlan) ON (n.companyId)",
+    "CREATE CONSTRAINT infra_cost_id IF NOT EXISTS FOR (n:InfrastructureCost) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX infra_cost_cid IF NOT EXISTS FOR (n:InfrastructureCost) ON (n.companyId)",
+    "CREATE CONSTRAINT vendor_contract_id IF NOT EXISTS FOR (n:VendorContract) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX vendor_contract_cid IF NOT EXISTS FOR (n:VendorContract) ON (n.companyId)",
+    "CREATE CONSTRAINT cac_by_channel_id IF NOT EXISTS FOR (n:CACByChannel) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX cac_by_channel_cid IF NOT EXISTS FOR (n:CACByChannel) ON (n.companyId)",
+    // CS nodes
+    "CREATE CONSTRAINT acct_health_id IF NOT EXISTS FOR (n:AccountHealthScore) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX acct_health_cid IF NOT EXISTS FOR (n:AccountHealthScore) ON (n.companyId)",
+    "CREATE CONSTRAINT customer_journey_id IF NOT EXISTS FOR (n:CustomerJourneyNode) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX customer_journey_cid IF NOT EXISTS FOR (n:CustomerJourneyNode) ON (n.companyId)",
+    "CREATE CONSTRAINT renewal_id IF NOT EXISTS FOR (n:Renewal) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX renewal_cid IF NOT EXISTS FOR (n:Renewal) ON (n.companyId)",
+    "CREATE CONSTRAINT expansion_opp_id IF NOT EXISTS FOR (n:ExpansionOpportunity) REQUIRE n.id IS UNIQUE",
+    "CREATE INDEX expansion_opp_cid IF NOT EXISTS FOR (n:ExpansionOpportunity) ON (n.companyId)",
+  ];
+
+  for (const stmt of migrations) {
+    try {
+      await mgQuery(stmt, {});
+    } catch (e) {
+      // IF NOT EXISTS protects against duplicates; log other errors
+      if (!e.message.includes('already exists') && !e.message.includes('IF NOT EXISTS')) {
+        console.warn('[schema-migrations-proj] SM-proj-08 warn:', e.message);
+      }
+    }
+  }
+}
+
+module.exports = { runProjectMigrations };