nexarch 0.9.12 → 0.9.14

package/dist/commands/init-project.js

@@ -898,14 +898,17 @@ function scanProject(dir) {
     };
 }
 // ─── Relationship type selection ──────────────────────────────────────────────
-function pickRelationshipType(toEntityTypeCode, _fromEntityTypeCode = "application") {
+function pickRelationshipType(toEntityTypeCode, toEntitySubtypeCode, _fromEntityTypeCode = "application") {
     switch (toEntityTypeCode) {
         case "model":
             return "uses_model";
         case "platform":
-        case "platform_component":
-            // runs_on is the valid ontology relationship from application/tech to platform
             return "runs_on";
+        case "platform_component":
+            // platform_service (Vercel Analytics, Vercel Postgres, Cloudinary, etc.) are opt-in
+            // managed services — integrates_with is the semantically correct relationship.
+            // Other platform_component subtypes (platform_runtime, platform_control_plane) use depends_on.
+            return toEntitySubtypeCode === "platform_service" ? "integrates_with" : "depends_on";
         case "skill":
             return "uses";
         case "technology_component":
@@ -1371,7 +1374,7 @@ export async function initProject(args) {
         if (!rootDepNames.has(r.input) && !rootDepNames.has(r.normalised))
             continue;
         const depSpec = rootDepVersions.get(r.input) ?? rootDepVersions.get(r.normalised);
-        addRel(pickRelationshipType(r.entityTypeCode), projectExternalKey, r.canonicalExternalRef, 0.9, {
+        addRel(pickRelationshipType(r.entityTypeCode, r.entitySubtypeCode), projectExternalKey, r.canonicalExternalRef, 0.9, {
             source: depSpec?.source ?? "manifest_scan",
             detected_at: nowIso,
             ...buildVersionAttributes(depSpec?.versionRaw ?? null, depSpec?.source ?? "manifest_scan"),
@@ -1391,7 +1394,7 @@ export async function initProject(args) {
             const r = resolvedByInput.get(dep.name);
             if (!r?.canonicalExternalRef || !r.entityTypeCode)
                 continue;
-            addRel(pickRelationshipType(r.entityTypeCode, sp.entityType), sp.externalKey, r.canonicalExternalRef, 0.9, {
+            addRel(pickRelationshipType(r.entityTypeCode, r.entitySubtypeCode, sp.entityType), sp.externalKey, r.canonicalExternalRef, 0.9, {
                 source: dep.source,
                 detected_at: nowIso,
                 ...buildVersionAttributes(dep.versionRaw, dep.source),
@@ -1524,7 +1527,7 @@ export async function initProject(args) {
                     .map((d) => resolvedByInput.get(d.name))
                     .filter((r) => !!r?.canonicalExternalRef)
                     .map((r) => {
-                    const relationshipTypeCode = pickRelationshipType(r.entityTypeCode, sp.entityType);
+                    const relationshipTypeCode = pickRelationshipType(r.entityTypeCode, r.entitySubtypeCode, sp.entityType);
                     const relationshipKey = `${relationshipTypeCode}::${sp.externalKey}::${r.canonicalExternalRef}`;
                     return {
                         canonicalExternalRef: r.canonicalExternalRef,
@@ -1577,8 +1580,9 @@ export async function initProject(args) {
     function buildEnrichmentDirective() {
         const lines = [];
         lines.push("─── ENRICHMENT REQUIRED ─────────────────────────────────────────────────");
-        lines.push("init-project wrote a skeleton. You must complete enrichment NOW, inline,");
-        lines.push("in this same session. Do NOT report the project as registered until done.");
+        lines.push("init-project wrote a skeleton. Complete enrichment NOW — do not ask the");
+        lines.push("user for permission, do not summarise and pause, just execute the steps.");
+        lines.push("Do NOT report the project as registered until enrichment is done.");
         lines.push("");
         lines.push(`PROJECT : ${projectExternalKey}`);
         lines.push(`DIR     : ${dir}`);
@@ -1616,12 +1620,24 @@ export async function initProject(args) {
                 lines.push(`  … and ${unresolvedItems.length - 20} more`);
         }
         lines.push("");
-        lines.push("THEN_RUN (once you have read the READMEs):");
+        lines.push("THEN_RUN (execute these steps immediately — do not pause or ask for confirmation):");
         let step = 1;
-        lines.push(`  ${step++}. nexarch update-entity --key "${projectExternalKey}" --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? ' --subtype "app_custom_built" --icon "<lucide-icon>"' : ""} --name "..." --description "..."`);
+        lines.push(`  ${step++}. nexarch update-entity --key "${projectExternalKey}" --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? ' --subtype "<subtype>" --icon "<lucide-icon>"' : ""} --name "..." --description "..."`);
+        if (entityTypeOverride === "application") {
+            lines.push(`     Valid subtypes: app_custom_built  app_saas  app_mobile  app_cli  app_integration_service  app_data_pipeline`);
+            lines.push(`     (choose app_custom_built as the default if none of the others clearly apply)`);
+        }
         if (subPackages.length > 0) {
             lines.push(`  ${step++}. Update each sub-package listed under CLASSIFY_THESE above.`);
         }
+        if (entityTypeOverride === "application") {
+            lines.push(`  ${step++}. Identify functional subsystems from the README and architecture docs.`);
+            lines.push(`     Look for named logical areas (e.g. Billing System, Auth Subsystem, Data Layer, API Service Layer).`);
+            lines.push(`     Only register subsystems that are explicitly named or described — do not invent them.`);
+            lines.push(`     For each one found:`);
+            lines.push(`       nexarch update-entity --key "application_component:${projectExternalKey.split(":")[1] ?? "project"}-<subsystem-slug>" --entity-type application_component --subtype app_comp_subsystem --name "..." --description "..."`);
+            lines.push(`       nexarch add-relationship --from "application_component:${projectExternalKey.split(":")[1] ?? "project"}-<subsystem-slug>" --to "${projectExternalKey}" --type part_of`);
+        }
         lines.push(`  ${step++}. Scan the READMEs for platforms/SaaS not auto-detected (Vercel, Neon, Stripe, etc.).`);
         lines.push(`       For each found: nexarch resolve-names --names "..." --json  →  nexarch update-entity  →  nexarch add-relationship`);
         lines.push(`  ${step++}. Look for ADRs (docs/adr/, decisions/, ADR-*.md) and register decision_record entities.`);

package/dist/commands/update-entity.js

@@ -52,7 +52,7 @@ export async function updateEntity(args) {
         console.error("error: batch entity updates were removed. Use explicit per-entity update-entity commands for enrichment quality.");
         process.exit(1);
     }
-    const externalKey = parseOptionValue(args, "--key");
+    const externalKey = parseOptionValue(args, "--key") ?? parseOptionValue(args, "--external-key");
     const name = parseOptionValue(args, "--name");
     const description = parseOptionValue(args, "--description");
     const entityTypeCode = parseOptionValue(args, "--entity-type") ?? "application";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.9.12",
+  "version": "0.9.14",
   "description": "Your architecture workspace for AI delivery.",
   "keywords": [
     "nexarch",