@c4a/core 0.4.12-alpha.3 → 0.4.12-beta.7

package/index.js

@@ -7000,6 +7000,7 @@ var RelationType;
   RelationType2["Triggers"] = "TRIGGERS";
   RelationType2["References"] = "REFERENCES";
   RelationType2["Corresponds"] = "CORRESPONDS";
+  RelationType2["Mentions"] = "MENTIONS";
 })(RelationType ||= {});
 var AtomField;
 ((AtomField2) => {
@@ -7017,6 +7018,7 @@ var AtomField;
   AtomField2["Constraints"] = "constraints";
   AtomField2["Comparisons"] = "comparisons";
   AtomField2["Boundaries"] = "boundaries";
+  AtomField2["Claims"] = "claims";
 })(AtomField ||= {});
 var Kind;
 ((Kind2) => {
@@ -7029,12 +7031,124 @@ var Perspective;
   Perspective2["Business"] = "business";
   Perspective2["Technical"] = "technical";
 })(Perspective ||= {});
+// src/types/edgeSyncRules.ts
+var EDGE_SYNC_RULES = [
+  {
+    field: "container_id",
+    sourceEntityType: "component" /* Component */,
+    edgeType: "CONTAINS" /* Contains */,
+    direction: "reverse",
+    writeGraph: true
+  },
+  {
+    field: "system_id",
+    sourceEntityType: "container" /* Container */,
+    edgeType: "CONTAINS" /* Contains */,
+    direction: "reverse",
+    writeGraph: true
+  },
+  {
+    field: "ref_sor",
+    sourceEntityType: "sor" /* SoR */,
+    edgeType: "REFERENCES" /* References */,
+    direction: "forward",
+    writeGraph: true
+  },
+  {
+    field: "product_refs",
+    sourceEntityType: "epic" /* Epic */,
+    edgeType: "REFERENCES" /* References */,
+    direction: "forward",
+    writeGraph: true
+  },
+  {
+    field: "atoms.entities.ref",
+    sourceEntityType: "any",
+    edgeType: "MENTIONS" /* Mentions */,
+    direction: "forward",
+    writeGraph: true
+  },
+  {
+    field: "atoms.behaviors.ref",
+    sourceEntityType: "any",
+    edgeType: "MENTIONS" /* Mentions */,
+    direction: "forward",
+    writeGraph: true
+  },
+  {
+    field: "product_id",
+    sourceEntityType: "sor" /* SoR */,
+    edgeType: null,
+    direction: "forward",
+    writeGraph: false
+  },
+  {
+    field: "process_id",
+    sourceEntityType: "sor" /* SoR */,
+    edgeType: "PRODUCES" /* Produces */,
+    direction: "reverse",
+    writeGraph: true
+  }
+];
+// src/types/refPointer.ts
+var REF_POINTER_PATTERN = /^ref:(entity|relation|content):(.+)$/;
+function parseRef(pointer) {
+  const match = REF_POINTER_PATTERN.exec(pointer);
+  if (!match) {
+    return null;
+  }
+  const [, type, id] = match;
+  if (!id) {
+    return null;
+  }
+  return { type, id };
+}
+function buildRef(type, id) {
+  return `ref:${type}:${id}`;
+}
+function isRefPointer(value) {
+  return typeof value === "string" && parseRef(value) !== null;
+}
+function extractAllRefs(data) {
+  const results = [];
+  const visit = (value, path) => {
+    if (typeof value === "string") {
+      if (isRefPointer(value)) {
+        results.push({ pointer: value, fieldPath: path });
+      }
+      return;
+    }
+    if (Array.isArray(value)) {
+      value.forEach((item, index) => {
+        const nextPath = path ? `${path}[${index}]` : `[${index}]`;
+        visit(item, nextPath);
+      });
+      return;
+    }
+    if (value && typeof value === "object") {
+      for (const [key, entry] of Object.entries(value)) {
+        const nextPath = path ? `${path}.${key}` : key;
+        visit(entry, nextPath);
+      }
+    }
+  };
+  visit(data, "");
+  return results;
+}
 // src/types/serverConfig.ts
 var DEFAULT_SERVER_CONFIG = {
   server: {
     port: 5100,
     host: "::"
   },
+  git_hosts: [],
+  daemon_scheduler: {
+    enabled: true,
+    host: "localhost",
+    port: 5110,
+    workspace: "./data/daemon-workspace",
+    max_daemons: 20
+  },
   doc_db: {
     provider: "sqlite",
     sqlite: {
@@ -7057,6 +7171,9 @@ var DEFAULT_SERVER_CONFIG = {
       username: "root",
       password: "nebula",
       space: "c4a"
+    },
+    duckdb: {
+      path: "./data/c4a-graph.duckdb"
     }
   },
   vector_db: {
@@ -11158,7 +11275,7 @@ var atomFieldSchema = exports_external.enum(Object.values(AtomField));
 var kindSchema = exports_external.enum(Object.values(Kind));
 var scopeSchema = exports_external.literal("project");
 var perspectiveSchema = exports_external.enum(Object.values(Perspective));
-var confidenceSchema = exports_external.object({
+var extractionConfidenceSchema = exports_external.object({
   structural: exports_external.number().min(0).max(1),
   semantic: exports_external.number().min(0).max(1)
 });
@@ -11166,13 +11283,29 @@ var metadataSchema = exports_external.object({
   created_at: exports_external.string().datetime(),
   updated_at: exports_external.string().datetime(),
   version_tag: exports_external.string().optional(),
-  confidence: confidenceSchema.optional()
+  extraction_confidence: extractionConfidenceSchema.optional(),
+  confidence: exports_external.number().min(0).max(1).optional(),
+  aliases: exports_external.array(exports_external.string()).optional(),
+  rank: exports_external.number().optional(),
+  community_id: exports_external.string().optional(),
+  community_level: exports_external.number().optional()
+});
+var entityRefPointerSchema = exports_external.string().regex(/^ref:entity:.+$/, "must be a ref pointer in format ref:entity:<id>");
+var sourceRefSpanSchema = exports_external.object({
+  start: exports_external.number().int().min(1),
+  end: exports_external.number().int().min(1)
+});
+var sourceRefSchema = exports_external.object({
+  ref: exports_external.string(),
+  span: sourceRefSpanSchema.optional()
 });
+var sourceRefsSchema = exports_external.array(sourceRefSchema).optional();
 // src/schemas/atomsSchema.ts
 var confidenceAtomSchema = exports_external.number().min(0).max(1).optional();
 var entityAtomSchema = exports_external.object({
   name: exports_external.string(),
   kind: kindSchema.optional(),
+  ref: exports_external.string().optional(),
   confidence: confidenceAtomSchema
 });
 var relationAtomSchema = exports_external.object({
@@ -11186,6 +11319,8 @@ var behaviorAtomSchema = exports_external.object({
   name: exports_external.string(),
   signature: exports_external.string().optional(),
   description: exports_external.string().optional(),
+  performed_by: exports_external.array(exports_external.string()).optional(),
+  ref: exports_external.string().optional(),
   confidence: confidenceAtomSchema
 });
 var attributeAtomSchema = exports_external.object({
@@ -11226,6 +11361,7 @@ var decisionPhaseSchema = exports_external.object({
   rationale: exports_external.string().optional()
 });
 var decisionAtomSchema = exports_external.object({
+  name: exports_external.string().optional(),
   description: exports_external.string(),
   rationale: exports_external.string(),
   alternatives: exports_external.array(exports_external.string()).optional(),
@@ -11248,9 +11384,9 @@ var metricAtomSchema = exports_external.object({
 });
 var roleAtomSchema = exports_external.object({
   name: exports_external.string(),
-  kind: exports_external.enum(["internal", "external"]),
+  kind: exports_external.enum(["human", "team", "persona"]),
   performs: exports_external.array(exports_external.string()).optional(),
-  confidence: confidenceAtomSchema
+  description: exports_external.string().optional()
 });
 var constraintAtomSchema = exports_external.object({
   description: exports_external.string(),
@@ -11281,6 +11417,16 @@ var comparisonAtomSchema = exports_external.object({
   decision_ref: exports_external.string().optional(),
   confidence: confidenceAtomSchema
 });
+var claimAtomSchema = exports_external.object({
+  claim_type: exports_external.string(),
+  description: exports_external.string(),
+  status: exports_external.enum(["active", "deprecated", "proposed"]),
+  valid_from: exports_external.string(),
+  valid_until: exports_external.string().optional(),
+  session_ref: exports_external.string().optional(),
+  changed_by: exports_external.string(),
+  confidence: confidenceAtomSchema
+});
 var dataAtomsSchema = exports_external.object({
   entities: exports_external.array(entityAtomSchema).optional(),
   relations: exports_external.array(relationAtomSchema).optional(),
@@ -11295,31 +11441,115 @@ var dataAtomsSchema = exports_external.object({
   roles: exports_external.array(roleAtomSchema).optional(),
   constraints: exports_external.array(constraintAtomSchema).optional(),
   comparisons: exports_external.array(comparisonAtomSchema).optional(),
-  boundaries: exports_external.array(boundaryAtomSchema).optional()
+  boundaries: exports_external.array(boundaryAtomSchema).optional(),
+  claims: exports_external.array(claimAtomSchema).optional()
 }).superRefine((atoms2, ctx) => {
-  if (!atoms2.transitions || atoms2.transitions.length === 0) {
-    return;
-  }
   const stateValues = new Set;
+  const stateNames = new Set;
   for (const state of atoms2.states ?? []) {
+    stateNames.add(state.name);
     for (const value of state.values) {
       stateValues.add(value);
     }
   }
-  for (const transition of atoms2.transitions) {
-    if (!stateValues.has(transition.from)) {
-      ctx.addIssue({
-        code: exports_external.ZodIssueCode.custom,
-        path: ["transitions"],
-        message: `transition.from references unknown state: ${transition.from}`
-      });
+  const behaviorNames = new Set;
+  for (const behavior of atoms2.behaviors ?? []) {
+    behaviorNames.add(behavior.name);
+  }
+  const roleNames = new Set;
+  for (const role of atoms2.roles ?? []) {
+    roleNames.add(role.name);
+  }
+  const eventNames = new Set;
+  for (const event of atoms2.events ?? []) {
+    eventNames.add(event.name);
+  }
+  const metricNames = new Set;
+  for (const metric of atoms2.metrics ?? []) {
+    metricNames.add(metric.name);
+  }
+  if (atoms2.transitions && atoms2.transitions.length > 0) {
+    for (const transition of atoms2.transitions) {
+      if (!stateValues.has(transition.from)) {
+        ctx.addIssue({
+          code: exports_external.ZodIssueCode.custom,
+          path: ["transitions"],
+          message: `transition.from references unknown state: ${transition.from}`
+        });
+      }
+      if (!stateValues.has(transition.to)) {
+        ctx.addIssue({
+          code: exports_external.ZodIssueCode.custom,
+          path: ["transitions"],
+          message: `transition.to references unknown state: ${transition.to}`
+        });
+      }
+      const hasEvents = eventNames.size > 0;
+      const hasBehaviors = behaviorNames.size > 0;
+      if (hasEvents || hasBehaviors) {
+        const triggerMatchesEvent = hasEvents && eventNames.has(transition.trigger);
+        const triggerMatchesBehavior = hasBehaviors && behaviorNames.has(transition.trigger);
+        if (!triggerMatchesEvent && !triggerMatchesBehavior) {
+          ctx.addIssue({
+            code: exports_external.ZodIssueCode.custom,
+            path: ["transitions"],
+            message: `transition.trigger references unknown event/behavior: ${transition.trigger}`
+          });
+        }
+      }
     }
-    if (!stateValues.has(transition.to)) {
-      ctx.addIssue({
-        code: exports_external.ZodIssueCode.custom,
-        path: ["transitions"],
-        message: `transition.to references unknown state: ${transition.to}`
-      });
+  }
+  if (atoms2.roles && atoms2.roles.length > 0) {
+    for (const [index, role] of atoms2.roles.entries()) {
+      for (const perform of role.performs ?? []) {
+        if (!behaviorNames.has(perform)) {
+          ctx.addIssue({
+            code: exports_external.ZodIssueCode.custom,
+            path: ["roles", index, "performs"],
+            message: `role.performs references unknown behavior: ${perform}`
+          });
+        }
+      }
+    }
+  }
+  if (atoms2.behaviors && atoms2.behaviors.length > 0) {
+    for (const [index, behavior] of atoms2.behaviors.entries()) {
+      for (const performer of behavior.performed_by ?? []) {
+        if (!roleNames.has(performer)) {
+          ctx.addIssue({
+            code: exports_external.ZodIssueCode.custom,
+            path: ["behaviors", index, "performed_by"],
+            message: `behavior.performed_by references unknown role: ${performer}`
+          });
+        }
+      }
+    }
+  }
+  if (atoms2.rules && atoms2.rules.length > 0) {
+    const allowedDependsOn = new Set([...stateNames, ...metricNames]);
+    for (const [index, rule] of atoms2.rules.entries()) {
+      for (const dependency of rule.depends_on ?? []) {
+        if (!allowedDependsOn.has(dependency)) {
+          ctx.addIssue({
+            code: exports_external.ZodIssueCode.custom,
+            path: ["rules", index, "depends_on"],
+            message: `rule.depends_on references unknown state/metric: ${dependency}`
+          });
+        }
+      }
+    }
+  }
+  if (atoms2.events && atoms2.events.length > 0) {
+    for (const [index, event] of atoms2.events.entries()) {
+      for (const behaviorName of event.trigger_for ?? []) {
+        if (!behaviorNames.has(behaviorName)) {
+          ctx.addIssue({
+            code: exports_external.ZodIssueCode.custom,
+            path: ["events", index, "trigger_for"],
+            message: `event.trigger_for references unknown behavior: ${behaviorName}`
+          });
+        }
+      }
     }
   }
 });
@@ -11335,7 +11565,8 @@ var atomsWhitelistByEntityType = {
     "states" /* States */,
     "rules" /* Rules */,
     "transitions" /* Transitions */,
-    "events" /* Events */
+    "events" /* Events */,
+    "claims" /* Claims */
   ]),
   ["process" /* Process */]: new Set,
   ["sor" /* SoR */]: new Set([
@@ -11351,7 +11582,8 @@ var atomsWhitelistByEntityType = {
     "metrics" /* Metrics */,
     "roles" /* Roles */,
     "constraints" /* Constraints */,
-    "comparisons" /* Comparisons */
+    "comparisons" /* Comparisons */,
+    "claims" /* Claims */
   ]),
   ["contract" /* Contract */]: new Set,
   ["epic" /* Epic */]: new Set([
@@ -11359,7 +11591,8 @@ var atomsWhitelistByEntityType = {
     "metrics" /* Metrics */,
     "roles" /* Roles */,
     "constraints" /* Constraints */,
-    "comparisons" /* Comparisons */
+    "comparisons" /* Comparisons */,
+    "claims" /* Claims */
   ]),
   ["document" /* Document */]: new Set
 };
@@ -11385,7 +11618,8 @@ var baseEntitySchema = exports_external.object({
   kind: kindSchema,
   scope: scopeSchema,
   perspective: perspectiveSchema,
-  metadata: metadataSchema
+  metadata: metadataSchema,
+  source_refs: sourceRefsSchema
 });
 var productDataSchema = exports_external.object({
   description: exports_external.string().optional(),
@@ -11399,7 +11633,8 @@ var productEntitySchema = baseEntitySchema.extend({
 });
 var systemDataSchema = exports_external.object({
   description: exports_external.string().optional(),
-  corresponds_to: exports_external.string().optional()
+  corresponds_to: exports_external.string().optional(),
+  atoms: exports_external.undefined().optional()
 });
 var systemEntitySchema = baseEntitySchema.extend({
   type: exports_external.literal("system" /* System */),
@@ -11445,9 +11680,10 @@ var sorEntitySchema = baseEntitySchema.extend({
   data: sorDataSchema
 });
 var contractDataSchema = exports_external.object({
-  format: exports_external.enum(["openapi", "asyncapi", "proto"]),
+  format: exports_external.enum(["openapi", "asyncapi", "proto", "graphql", "custom"]),
   spec: exports_external.string(),
-  component_id: exports_external.string().optional()
+  version: exports_external.string().optional(),
+  description: exports_external.string().optional()
 });
 var contractEntitySchema = baseEntitySchema.extend({
   type: exports_external.literal("contract" /* Contract */),
@@ -11455,7 +11691,7 @@ var contractEntitySchema = baseEntitySchema.extend({
 });
 var epicDataSchema = exports_external.object({
   description: exports_external.string().optional(),
-  product_refs: exports_external.array(exports_external.string()).optional(),
+  product_refs: exports_external.array(entityRefPointerSchema).optional(),
   atoms: dataAtomsSchema.optional()
 });
 var epicEntitySchema = baseEntitySchema.extend({
@@ -11531,18 +11767,45 @@ var entitySchema = exports_external.discriminatedUnion("type", [
       });
     }
   }
+  if (entity2.type === "sor" /* SoR */ && entity2.data.atoms) {
+    const { constraints, rules } = entity2.data.atoms;
+    const hasConstraints = Array.isArray(constraints) && constraints.length > 0;
+    const hasRules = Array.isArray(rules) && rules.length > 0;
+    if (!hasConstraints && !hasRules) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        path: ["data", "atoms"],
+        message: "SoR must have at least one constraint or rule"
+      });
+    }
+  }
+  if (entity2.type === "epic" /* Epic */ && entity2.data.atoms) {
+    const { decisions } = entity2.data.atoms;
+    const hasDecisions = Array.isArray(decisions) && decisions.length > 0;
+    if (!hasDecisions) {
+      ctx.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        path: ["data", "atoms"],
+        message: "Epic must have at least one decision"
+      });
+    }
+  }
 });
 // src/schemas/relationSchema.ts
 var relationDataSchema = exports_external.object({
-  description: exports_external.string().optional()
+  description: exports_external.string().optional(),
+  _source: exports_external.literal("field_sync").optional()
 });
 var relationSchema = exports_external.object({
   id: exports_external.string(),
   type: relationTypeSchema,
   from: exports_external.string(),
   to: exports_external.string(),
+  weight: exports_external.number().optional(),
+  confidence: exports_external.number().min(0).max(1).optional(),
   data: relationDataSchema.optional(),
-  metadata: metadataSchema.optional()
+  metadata: metadataSchema.optional(),
+  source_refs: sourceRefsSchema
 });
 // src/errors/c4aError.ts
 class C4AError extends Error {
@@ -11689,6 +11952,7 @@ var DEFAULT_CLOUD_LIBRARY_ID = "lib_cloud_default";
 var DEFAULT_CLOUD_LIBRARY_NAME = "个人云";
 var DAEMON_HEARTBEAT_INTERVAL = 30000;
 var DAEMON_OFFLINE_THRESHOLD = 60000;
+var CLOUD_DAEMON_IDLE_TIMEOUT = 300000;
 // src/fileTypes.ts
 var INDEXABLE_CODE_EXTENSIONS = new Set([".ts", ".tsx"]);
 var INDEXABLE_DOC_EXTENSIONS = new Set([".md"]);
@@ -11733,6 +11997,9 @@ export {
   transitionAtomSchema,
   systemEntitySchema,
   stateAtomSchema,
+  sourceRefsSchema,
+  sourceRefSpanSchema,
+  sourceRefSchema,
   sorEntitySchema,
   sessionDecisionSchema,
   serializeYaml,
@@ -11747,6 +12014,7 @@ export {
   processEntitySchema,
   perspectiveSchema,
   parseYaml,
+  parseRef,
   modelingSessionDataSchema,
   metricMilestoneSchema,
   metricAtomSchema,
@@ -11754,15 +12022,19 @@ export {
   mapErrorCodeToStatus,
   kindSchema,
   isValidManifest,
+  isRefPointer,
   isPathSafe,
   isIndexableFile,
   getFileExtension,
   generateUUID,
   generateId,
+  extractionConfidenceSchema,
+  extractAllRefs,
   eventAtomSchema,
   epicEntitySchema,
   entityTypeSchema,
   entitySchema,
+  entityRefPointerSchema,
   entityAtomSchema,
   documentSchema,
   documentModelingEntitySchema,
@@ -11772,14 +12044,16 @@ export {
   decisionAtomSchema,
   dataAtomsSchema,
   contractEntitySchema,
+  contractDataSchema,
   contentHash,
   containerEntitySchema,
   constraintAtomSchema,
-  confidenceSchema,
   componentEntitySchema,
   comparisonDimensionValueSchema,
   comparisonDimensionSchema,
   comparisonAtomSchema,
+  claimAtomSchema,
+  buildRef,
   boundaryAtomSchema,
   behaviorAtomSchema,
   attributeAtomSchema,
@@ -11807,6 +12081,7 @@ export {
   INDEXABLE_CODE_EXTENSIONS,
   ErrorCode,
   EntityType,
+  EDGE_SYNC_RULES,
   DEFAULT_WORKSPACE_NAME,
   DEFAULT_WORKSPACE_ID,
   DEFAULT_USER_NAME,
@@ -11817,6 +12092,7 @@ export {
   DAEMON_OFFLINE_THRESHOLD,
   DAEMON_HEARTBEAT_INTERVAL,
   CODE_PACKAGE_FILES,
+  CLOUD_DAEMON_IDLE_TIMEOUT,
   C4AError,
   AtomField
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/core",
-  "version": "0.4.12-alpha.3",
+  "version": "0.4.12-beta.7",
   "type": "module",
   "dependencies": {
     "yaml": "^2.4.5",