nexarch 0.5.1 → 0.5.3

package/dist/commands/check-in.js

@@ -35,11 +35,6 @@ function loadIdentity() {
         return { agentKey: null, projectKeys: [] };
     }
 }
-const COMMAND_TYPE_HINTS = {
-    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'.",
-    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) {
     const asJson = parseFlag(args, "--json");
     const agentKeyArg = parseOptionValue(args, "--agent-key");
@@ -66,8 +61,7 @@ export async function checkIn(args) {
     }, mcpOpts);
     const result = parseToolText(raw);
     if (asJson) {
-        const hint = result.command ? (COMMAND_TYPE_HINTS[result.command.command_type] ?? null) : null;
-        process.stdout.write(JSON.stringify({ ...result, hint }) + "\n");
+        process.stdout.write(JSON.stringify(result) + "\n");
         return;
     }
     if (!result.command) {
@@ -75,7 +69,6 @@ export async function checkIn(args) {
         return;
     }
     const cmd = result.command;
-    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(`╚══════════════════════════════════════════════════════════════════╝`);
@@ -83,11 +76,17 @@ export async function checkIn(args) {
     console.log(`Type       : ${cmd.command_type}`);
     console.log(`Target     : ${cmd.target_entity_key ?? "(any)"}`);
     console.log(`Priority   : ${cmd.priority}`);
+    if (cmd.resolved_execution_mode)
+        console.log(`Mode       : ${cmd.resolved_execution_mode}`);
+    if (cmd.resolved_runtime_handler)
+        console.log(`Runtime    : ${cmd.resolved_runtime_handler}`);
+    if (cmd.command_type_version != null)
+        console.log(`Type ver   : ${cmd.command_type_version}`);
     if (Object.keys(cmd.command_params).length > 0) {
         console.log(`Params     : ${JSON.stringify(cmd.command_params)}`);
     }
-    if (hint) {
-        console.log(`\n${hint}`);
+    if (cmd.resolved_playbook_text?.trim()) {
+        console.log(`\nPlaybook:\n${cmd.resolved_playbook_text}`);
     }
     if (cmd.instructions) {
         console.log(`\nInstructions:\n${cmd.instructions}`);

package/dist/commands/init-agent.js

@@ -1,11 +1,11 @@
 import { arch, homedir, hostname, platform, release, type as osType, userInfo } from "os";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "fs";
 import { join } from "path";
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { fetchAgentRegistryOrThrow } from "../lib/agent-registry.js";
 import { callMcpTool, mcpInitialize, mcpListTools } from "../lib/mcp.js";
-const CLI_VERSION = "0.5.1";
+const CLI_VERSION = "0.5.3";
 const AGENT_ENTITY_TYPE = "agent";
 const TECH_COMPONENT_ENTITY_TYPE = "technology_component";
 function parseFlag(args, flag) {
@@ -47,6 +47,32 @@ function getRuntimeMode() {
         return "ci";
     return "interactive";
 }
+function detectLikelyApplicationInCwd() {
+    const cwd = process.cwd();
+    const files = [
+        "package.json",
+        "pyproject.toml",
+        "requirements.txt",
+        "go.mod",
+        "Cargo.toml",
+        "Gemfile",
+        "composer.json",
+        "pom.xml",
+        "build.gradle",
+        "build.gradle.kts",
+    ];
+    const evidence = files.filter((file) => existsSync(join(cwd, file)));
+    try {
+        const entries = readdirSync(cwd);
+        if (entries.some((name) => name.toLowerCase().endsWith(".csproj"))) {
+            evidence.push("*.csproj");
+        }
+    }
+    catch {
+        // non-fatal; ignore
+    }
+    return { detected: evidence.length > 0, evidence };
+}
 function getSanitizedHostname(redactHostname) {
     const raw = hostname() || "unknown-host";
     return redactHostname ? "redacted" : raw;
@@ -718,6 +744,7 @@ export async function initAgent(args) {
         });
     }
     const allPassed = checks.every((c) => c.ok);
+    const appDetection = detectLikelyApplicationInCwd();
     const identifyPrompt = [
         "Please identify your runtime so the workspace can register richer metadata.",
         "Return ONLY the completed command below with real values (no markdown):",
@@ -751,6 +778,17 @@ export async function initAgent(args) {
                 detail: "Prompt the coding agent to self-identify and submit via nexarch agent identify",
                 prompt: identifyPrompt,
                 submitCommandTemplate: `nexarch agent identify --agent-id \"${agentId}\" --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<openclaw|n8n|m365-agent-framework|other>\" --session-id \"<session-id>\" --tool-version \"<tool-version>\" --capabilities \"<capability1,capability2>\" --notes \"<optional notes>\" --json`,
+                initProjectSuggestion: appDetection.detected
+                    ? {
+                        shouldPromptUser: true,
+                        reason: `Detected likely project manifests in cwd: ${appDetection.evidence.join(", ")}`,
+                        userPrompt: "I found a likely application in this directory. Do you want me to run init-project next?",
+                        suggestedCommand: "npx nexarch@latest init-project --dir . --json",
+                    }
+                    : {
+                        shouldPromptUser: false,
+                        reason: "No common application manifest files detected in current directory.",
+                    },
             },
             companyId: creds.companyId,
             registry: { version: registry.release.version, registryVersion: registry.registryVersion, publishedAt: registry.release.publishedAt },
@@ -793,6 +831,12 @@ export async function initAgent(args) {
             console.log("   Paste this and fill in real values:");
             console.log(`\nrun npx nexarch@latest agent identify --agent-id \"${agentId}\" --provider \"<provider>\" --model \"<model>\" --client \"<client>\" --framework \"<openclaw|n8n|m365-agent-framework|other>\" --tool-version \"<tool-version>\" --capabilities \"<capability1,capability2>\" --json\n`);
         }
+        if (appDetection.detected) {
+            console.log("\n➡ Optional next step: likely application detected in current directory.");
+            console.log(`   Detected manifests: ${appDetection.evidence.join(", ")}`);
+            console.log("   Ask the user: 'I found a likely application here. Do you want me to run init-project next?'");
+            console.log("   Suggested command: npx nexarch@latest init-project --dir . --json");
+        }
     }
     else {
         console.log("⚠ Handshake/registration completed with issues.");

package/dist/commands/init-project.js

@@ -5,7 +5,6 @@ import { basename, join, relative, resolve as resolvePath } from "node:path";
 import { homedir } from "node:os";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
-import { CURATED_AGENT_ICON_NAMES } from "../lib/application-icons.js";
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 function parseFlag(args, flag) {
     return args.includes(flag);
@@ -988,7 +987,6 @@ export async function initProject(args) {
         const ecosystemLabel = detectedEcosystems.length > 0
             ? detectedEcosystems.join(", ")
             : "unknown";
-        const curatedIconList = CURATED_AGENT_ICON_NAMES.join(", ");
         const manifestHint = detectedEcosystems.includes("nodejs")
             ? "package.json"
             : detectedEcosystems.includes("python")
@@ -1022,9 +1020,9 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
       → --entity-type technology_component --subtype tech_library
 
   ICON ASSIGNMENT (applications only):
-    • Pick one icon from this curated set for each application/sub-app.
+    • Pick one icon from the full Lucide icon set for each application/sub-app.
     • If confidence is low, skip --icon rather than guessing.
-    • Allowed icons: ${curatedIconList}
+    • Use kebab-case icon names (example: server, workflow, shield-check).
 
   For each sub-package, run update-entity to register it:
 
@@ -1034,7 +1032,7 @@ ${subPackages.map((sp) => `    • ${sp.name}  (${sp.relativePath})`).join("\n")
     --subtype "<chosen subtype>" \\
     --name "<human readable name>" \\
     --description "<what this package does and its role in the project>" \\
-    --icon "<curated icon>"   # applications only
+    --icon "<lucide icon>"   # applications only
 
   Then register it as a resolvable alias so future scans don't re-surface it as a candidate:
 
@@ -1149,7 +1147,7 @@ STEP 2 — Enrich the project entity. Run this command with the description you'
 
   npx nexarch update-entity \\
     --key "${projectExternalKey}" \\
-    --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? " \\\n    --subtype \"app_custom_built\"\n    --icon \"<curated icon>\"" : ""} \\
+    --entity-type "${entityTypeOverride}"${entityTypeOverride === "application" ? " \\\n    --subtype \"app_custom_built\" \\\n    --icon \"<curated icon>\"" : ""} \\
     --name "<proper product name from README>" \\
     --description "<2–4 sentence summary of what it does and why>"
 ${subPkgSection}${gapCheckSection}`;
@@ -1158,8 +1156,7 @@ ${subPkgSection}${gapCheckSection}`;
         instructions: buildEnrichmentInstructions(),
         iconHints: {
             provider: "lucide",
-            curated: CURATED_AGENT_ICON_NAMES,
-            note: "Use curated list for agent-selected enrichment icons; omit icon when low confidence.",
+            note: "Use any Lucide icon name for agent-selected enrichment icons; omit icon when low confidence.",
         },
         projectEntity: {
             externalKey: projectExternalKey,

package/dist/commands/update-entity.js

@@ -1,7 +1,6 @@
 import process from "process";
 import { requireCredentials } from "../lib/credentials.js";
 import { callMcpTool } from "../lib/mcp.js";
-import { CURATED_AGENT_ICON_SET } from "../lib/application-icons.js";
 function parseFlag(args, flag) {
     return args.includes(flag);
 }
@@ -52,10 +51,6 @@ export async function updateEntity(args) {
     const policyContext = policyBundleHash
         ? { policyBundleHash, alignmentSummary: { score: 1, violations: [], waivers: [] } }
         : undefined;
-    if (iconName && !CURATED_AGENT_ICON_SET.has(iconName)) {
-        console.error(`error: --icon must be one of the curated agent icons (got '${iconName}')`);
-        process.exit(1);
-    }
     const entity = {
         externalKey,
         entityTypeCode,

package/dist/index.js

@@ -87,7 +87,7 @@ Usage:
                                --description <text>
                                --entity-type <code>  (default: application)
                                --subtype <code>
-                               --icon <lucide-name>  (curated set; for agent enrichment)
+                               --icon <lucide-name>  (full Lucide set; for agent enrichment)
                                --json
   nexarch add-relationship
                       Add a relationship between two existing graph entities.

package/dist/lib/application-icons.js

@@ -45,5 +45,259 @@ export const CURATED_AGENT_ICON_NAMES = [
     "target",
     "leaf",
     "heart-pulse",
+    "beer",
+    "a-arrow-down",
+    "a-arrow-up",
+    "a-large-small",
+    "accessibility",
+    "activity-square",
+    "air-vent",
+    "airplay",
+    "alarm-check",
+    "alarm-clock",
+    "alarm-clock-check",
+    "alarm-clock-minus",
+    "alarm-clock-off",
+    "alarm-clock-plus",
+    "alarm-minus",
+    "alarm-plus",
+    "alarm-smoke",
+    "album",
+    "alert-circle",
+    "alert-octagon",
+    "alert-triangle",
+    "align-center",
+    "align-center-horizontal",
+    "align-center-vertical",
+    "align-end-horizontal",
+    "align-end-vertical",
+    "align-horizontal-distribute-center",
+    "align-horizontal-distribute-end",
+    "align-horizontal-distribute-start",
+    "align-horizontal-justify-center",
+    "align-horizontal-justify-end",
+    "align-horizontal-justify-start",
+    "align-horizontal-space-around",
+    "align-horizontal-space-between",
+    "align-justify",
+    "align-left",
+    "align-right",
+    "align-start-horizontal",
+    "align-start-vertical",
+    "align-vertical-distribute-center",
+    "align-vertical-distribute-end",
+    "align-vertical-distribute-start",
+    "align-vertical-justify-center",
+    "align-vertical-justify-end",
+    "align-vertical-justify-start",
+    "align-vertical-space-around",
+    "align-vertical-space-between",
+    "ambulance",
+    "ampersand",
+    "ampersands",
+    "amphora",
+    "anchor",
+    "angry",
+    "annoyed",
+    "antenna",
+    "anvil",
+    "aperture",
+    "app-window",
+    "app-window-mac",
+    "apple",
+    "archive",
+    "archive-restore",
+    "archive-x",
+    "area-chart",
+    "armchair",
+    "arrow-big-down",
+    "arrow-big-down-dash",
+    "arrow-big-left",
+    "arrow-big-left-dash",
+    "arrow-big-right",
+    "arrow-big-right-dash",
+    "arrow-big-up",
+    "arrow-big-up-dash",
+    "arrow-down",
+    "arrow-down-0-1",
+    "arrow-down-01",
+    "arrow-down-1-0",
+    "arrow-down-10",
+    "arrow-down-a-z",
+    "arrow-down-az",
+    "arrow-down-circle",
+    "arrow-down-from-line",
+    "arrow-down-left",
+    "arrow-down-left-from-circle",
+    "arrow-down-left-from-square",
+    "arrow-down-left-square",
+    "arrow-down-narrow-wide",
+    "arrow-down-right",
+    "arrow-down-right-from-circle",
+    "arrow-down-right-from-square",
+    "arrow-down-right-square",
+    "arrow-down-square",
+    "arrow-down-to-dot",
+    "arrow-down-to-line",
+    "arrow-down-up",
+    "arrow-down-wide-narrow",
+    "arrow-down-z-a",
+    "arrow-down-za",
+    "arrow-left",
+    "arrow-left-circle",
+    "arrow-left-from-line",
+    "arrow-left-right",
+    "arrow-left-square",
+    "arrow-left-to-line",
+    "arrow-right",
+    "arrow-right-circle",
+    "arrow-right-from-line",
+    "arrow-right-left",
+    "arrow-right-square",
+    "arrow-right-to-line",
+    "arrow-up",
+    "arrow-up-0-1",
+    "arrow-up-01",
+    "arrow-up-1-0",
+    "arrow-up-10",
+    "arrow-up-a-z",
+    "arrow-up-az",
+    "arrow-up-circle",
+    "arrow-up-down",
+    "arrow-up-from-dot",
+    "arrow-up-from-line",
+    "arrow-up-left",
+    "arrow-up-left-from-circle",
+    "arrow-up-left-from-square",
+    "arrow-up-left-square",
+    "arrow-up-narrow-wide",
+    "arrow-up-right",
+    "arrow-up-right-from-circle",
+    "arrow-up-right-from-square",
+    "arrow-up-right-square",
+    "arrow-up-square",
+    "arrow-up-to-line",
+    "arrow-up-wide-narrow",
+    "arrow-up-z-a",
+    "arrow-up-za",
+    "arrows-up-from-line",
+    "asterisk",
+    "asterisk-square",
+    "at-sign",
+    "atom",
+    "audio-lines",
+    "audio-waveform",
+    "award",
+    "axe",
+    "axis-3-d",
+    "axis-3d",
+    "baby",
+    "backpack",
+    "badge",
+    "badge-alert",
+    "badge-cent",
+    "badge-check",
+    "badge-dollar-sign",
+    "badge-euro",
+    "badge-help",
+    "badge-indian-rupee",
+    "badge-info",
+    "badge-japanese-yen",
+    "badge-minus",
+    "badge-percent",
+    "badge-plus",
+    "badge-pound-sterling",
+    "badge-question-mark",
+    "badge-russian-ruble",
+    "badge-swiss-franc",
+    "badge-turkish-lira",
+    "badge-x",
+    "baggage-claim",
+    "balloon",
+    "ban",
+    "banana",
+    "bandage",
+    "banknote",
+    "banknote-arrow-down",
+    "banknote-arrow-up",
+    "banknote-x",
+    "bar-chart",
+    "bar-chart-2",
+    "bar-chart-4",
+    "bar-chart-big",
+    "bar-chart-horizontal",
+    "bar-chart-horizontal-big",
+    "barcode",
+    "barrel",
+    "baseline",
+    "bath",
+    "battery",
+    "battery-charging",
+    "battery-full",
+    "battery-low",
+    "battery-medium",
+    "battery-plus",
+    "battery-warning",
+    "beaker",
+    "bean",
+    "bean-off",
+    "bed",
+    "bed-double",
+    "bed-single",
+    "beef",
+    "beef-off",
+    "beer-off",
+    "bell",
+    "bell-dot",
+    "bell-electric",
+    "bell-minus",
+    "bell-off",
+    "bell-plus",
+    "bell-ring",
+    "between-horizonal-end",
+    "between-horizonal-start",
+    "between-horizontal-end",
+    "between-horizontal-start",
+    "between-vertical-end",
+    "between-vertical-start",
+    "biceps-flexed",
+    "bike",
+    "binary",
+    "binoculars",
+    "biohazard",
+    "bird",
+    "birdhouse",
+    "bitcoin",
+    "blend",
+    "blinds",
+    "blocks",
+    "bluetooth",
+    "bluetooth-connected",
+    "bluetooth-off",
+    "bluetooth-searching",
+    "bold",
+    "bolt",
+    "bomb",
+    "bone",
+    "book",
+    "book-a",
+    "book-alert",
+    "book-audio",
+    "book-check",
+    "book-copy",
+    "book-dashed",
+    "book-down",
+    "book-headphones",
+    "book-heart",
+    "book-image",
+    "book-key",
+    "book-lock",
+    "book-marked",
+    "book-minus",
+    "book-open-check",
+    "book-open-text",
+    "book-plus",
+    "book-search",
+    "book-template",
 ];
 export const CURATED_AGENT_ICON_SET = new Set(CURATED_AGENT_ICON_NAMES);

package/dist/lib/mcp.js

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

package/package.json

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