nexarch 0.2.9 → 0.3.1

package/dist/commands/check-in.js

@@ -36,13 +36,8 @@ function loadIdentity() {
     }
 }
 const COMMAND_TYPE_HINTS = {
-    update_project: "Re-scan the project with `npx nexarch init-project` to update the architecture graph.",
-    drift_audit: "Compare the current codebase to the architecture graph and report any drift or missing entities.",
-    access_audit: "Audit which agents and users have access to this application and report findings.",
-    gap_check: "Run a gap analysis: identify architecturally significant platforms or infrastructure not yet in the graph.",
     policy_check: "Step 1: call nexarch_get_entity_policy_controls with entityExternalKey set to target_entity_key — this returns controls, each with a rules array (rule id, name, ruleText). Step 2: for each rule, examine the codebase and evaluate whether it passes, partially passes, or fails. Step 3: call nexarch_submit_policy_audit with applicationEntityKey, commandId, agentKey, and a findings array containing one entry per rule with policyControlId, policyRuleId, result (pass/partial/fail), rationale, and missingRequirements. Step 4: mark the command done with a brief summary. If no controls are returned, run command-fail with error 'No policy controls linked'.",
-    enrich_entity: "Update the entity description, subtype, and metadata using information from the README or codebase.",
-    register_aliases: "Find internal package names that are unresolved and register them as company aliases.",
+    data_model_review: "Goal: infer enterprise canonical logical data assets and map concrete physical implementations. 1) Identify logical business entities (canonical names, singular, enterprise meaning) and upsert as data_asset:data_logical. 2) Identify physical stores (tables/collections/files/indexes) and upsert as data_asset:data_physical with attributes (database, schema, table_name, store_type, source_system). 3) Link logical -> physical via implemented_by. 4) Link apps/services to physical via reads/writes. 5) Link logical assets to data domains via belongs_to_domain where evidence exists. 6) Avoid duplicate logical entities: reuse canonical logical entities if concept already exists. 7) Mark uncertain mappings with lower confidence in attributes.confidence.score and include rationale in command summary.",
     custom: "Execute the custom instructions provided.",
 };
 export async function checkIn(args) {
@@ -80,7 +75,7 @@ export async function checkIn(args) {
         return;
     }
     const cmd = result.command;
-    const hint = COMMAND_TYPE_HINTS[cmd.command_type] ?? "";
+    const hint = COMMAND_TYPE_HINTS[cmd.command_type] ?? "No built-in playbook for this command type. Follow the command instructions and complete/fail it explicitly.";
     console.log(`\n╔══════════════════════════════════════════════════════════════════╗`);
     console.log(`║  COMMAND QUEUED — action required                                ║`);
     console.log(`╚══════════════════════════════════════════════════════════════════╝`);

package/dist/commands/init-project.js

@@ -37,27 +37,33 @@ function parseEnvKeys(content) {
         .filter((key) => /^[A-Z][A-Z0-9_]{2,}$/.test(key))
         .filter((key) => !ENV_KEY_NOISE.test(key));
 }
-function detectFromGitConfig(dir) {
+function gitOriginUrl(dir) {
     const configPath = join(dir, ".git", "config");
     if (!existsSync(configPath))
-        return [];
+        return null;
     try {
         const content = readFileSync(configPath, "utf8");
-        // Match url under [remote "origin"]
         const match = content.match(/\[remote\s+"origin"\][^\[]*url\s*=\s*([^\n]+)/s);
         if (!match)
-            return [];
-        const url = match[1].trim();
-        if (url.includes("github.com"))
-            return ["github"];
-        if (url.includes("gitlab.com"))
-            return ["gitlab"];
-        if (url.includes("bitbucket.org"))
-            return ["bitbucket"];
-        if (url.includes("dev.azure.com") || url.includes("visualstudio.com"))
-            return ["azure-devops"];
+            return null;
+        return match[1].trim();
     }
-    catch { }
+    catch {
+        return null;
+    }
+}
+function detectFromGitConfig(dir) {
+    const url = gitOriginUrl(dir);
+    if (!url)
+        return [];
+    if (url.includes("github.com"))
+        return ["github"];
+    if (url.includes("gitlab.com"))
+        return ["gitlab"];
+    if (url.includes("bitbucket.org"))
+        return ["bitbucket"];
+    if (url.includes("dev.azure.com") || url.includes("visualstudio.com"))
+        return ["azure-devops"];
     return [];
 }
 function detectFromFilesystem(dir) {
@@ -555,6 +561,9 @@ export async function initProject(args) {
     const dir = resolvePath(dirArg);
     const nameOverride = parseOptionValue(args, "--name");
     const entityTypeOverride = parseOptionValue(args, "--entity-type") ?? "application";
+    const repoRefOverride = parseOptionValue(args, "--repo-ref");
+    const repoUrlOverride = parseOptionValue(args, "--repo-url");
+    const repoPathOverride = parseOptionValue(args, "--repo-path");
     const creds = requireCredentials();
     const mcpOpts = { companyId: creds.companyId };
     if (!asJson)
@@ -619,10 +628,15 @@ export async function initProject(args) {
     const policies = parseToolText(policiesRaw);
     const policyBundleHash = policies.policyBundleHash ?? null;
     const nowIso = new Date().toISOString();
+    const repoRef = repoRefOverride ?? dir;
+    const repoPath = repoPathOverride ?? dir;
+    const repoUrl = repoUrlOverride ?? null;
     const agentContext = {
         agentId: "nexarch-cli:init-project",
         agentRunId: `init-project-${Date.now()}`,
-        repoRef: dir,
+        repoRef,
+        repoPath,
+        ...(repoUrl ? { repoUrl } : {}),
         observedAt: nowIso,
         source: "nexarch-cli",
         model: "n/a",
@@ -641,7 +655,13 @@ export async function initProject(args) {
         ...(projectSubtype ? { entitySubtypeCode: projectSubtype } : {}),
         name: displayName,
         confidence: 1,
-        attributes: { source_dir: dir, scanned_at: nowIso, package_json_count: packageJsonCount },
+        attributes: {
+            source_dir: dir,
+            scanned_at: nowIso,
+            package_json_count: packageJsonCount,
+            ...(repoUrl ? { repository_url: repoUrl } : {}),
+            repository_ref: repoRef,
+        },
     });
     // Resolved reference entities (deduplicated by canonical external ref)
     const seenRefs = new Set();

package/dist/lib/mcp.js

@@ -62,7 +62,7 @@ export async function mcpInitialize(options = {}) {
     return callMcpRpc("initialize", {
         protocolVersion: "2024-11-05",
         capabilities: {},
-        clientInfo: { name: "nexarch-cli", version: "0.2.9" },
+        clientInfo: { name: "nexarch-cli", version: "0.3.1" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexarch",
-  "version": "0.2.9",
+  "version": "0.3.1",
   "description": "Connect AI coding tools to your Nexarch architecture workspace",
   "keywords": [
     "nexarch",