nexarch 0.2.8 → 0.3.0

package/dist/commands/check-in.js

@@ -40,7 +40,7 @@ const COMMAND_TYPE_HINTS = {
     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: "Gather evidence from the codebase (README, architecture summary, key file contents), then call nexarch_submit_policy_audit with applicationEntityKey set to target_entity_key, commandId set to the command id, agentKey set to your agent key, and the evidence you gathered. The tool evaluates all linked policy rules and persists structured findings. If it returns ok:false with APPLICATION_NOT_FOUND, run command-fail. If summary.totalRules is 0, run command-fail with error 'No policy rules linked to this application'.",
+    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.",
     custom: "Execute the custom instructions provided.",

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.8" },
+        clientInfo: { name: "nexarch-cli", version: "0.3.0" },
     }, options);
 }
 export async function mcpListTools(options = {}) {

package/package.json

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