@crewx/memory 0.1.23-rc.254 → 0.1.23-rc.255

package/README.md

@@ -5,3 +5,17 @@ Memory engine for CrewX - markdown + frontmatter based long-term memory.
 ```bash
 crewx memory index <agent_id>
 ```
+
+## Native read commands
+
+On supported npm installations, bare `index` and `get`, plus `find` with one non-empty query argument, use the packaged Go reader. The Node CLI remains the implementation for every write, AI-backed command, alias, flag-bearing form, empty query, and unsupported invocation. CrewX Desktop continues to use Node.
+
+```bash
+crewx memory index <agent_id>
+crewx memory get <agent_id> <memory_id>
+crewx memory find <agent_id> "<non-empty query>"
+```
+
+Set `CREWX_MEMORY_RUNTIME=node` to force the existing Node implementation. `auto` is the default and falls back to Node before execution if the command or packaged native artifact is unsupported, including an empty `find` query. `CREWX_MEMORY_RUNTIME=go` requires one of the three exact forms above and reports an error when native support is unavailable. A failed native operation is never retried in Node.
+
+The package currently includes native artifacts for macOS arm64/amd64, Linux arm64/amd64, and Windows amd64. Windows native operation still requires separate platform validation. After installing/building the Windows artifact, the foreground cleanup harness is `pwsh -File packages/built-in/memory/tests/windows-native-cleanup.ps1 -Launcher (Resolve-Path .\bin\crewx.js)`. Runtime artifact lookup is confined to the installed `@crewx/memory` package; no downloads are performed.

package/SKILL.md

@@ -8,6 +8,16 @@ metadata:
 
 # Memory V2 Skill
 
+## Native read routing
+
+The default `auto` runtime uses the packaged Go reader only for these exact bare commands:
+
+- `crewx memory index <agent_id>`
+- `crewx memory get <agent_id> <memory_id>`
+- `crewx memory find <agent_id> "<non-empty query>"`
+
+Flags, aliases, writes, AI-backed commands, empty queries, and all other memory commands continue through the existing Node implementation. CrewX Desktop also stays on Node. Set `CREWX_MEMORY_RUNTIME=node` to roll back explicitly; set `CREWX_MEMORY_RUNTIME=go` to require native support and fail with an actionable error when it is unavailable. `auto` falls back before a native operation starts. It never retries a failed native operation in Node.
+
 A long-term memory management skill based on markdown + frontmatter.
 
 ## Installation

package/dist/src/parser.d.ts

@@ -1,3 +1,6 @@
-export { parseFrontmatter, stringifyFrontmatter } from '@crewx/knowledge-core';
-export type { ParsedFrontmatter } from '@crewx/knowledge-core';
+import { stringifyFrontmatter } from '@crewx/knowledge-core';
+import type { ParsedFrontmatter } from '@crewx/knowledge-core';
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter;
+export { stringifyFrontmatter };
+export type { ParsedFrontmatter };
                                     

package/dist/src/parser.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.stringifyFrontmatter=exports.parseFrontmatter=void 0;var e=require("@crewx/knowledge-core");Object.defineProperty(exports,"parseFrontmatter",{enumerable:true,get:function(){return e.parseFrontmatter}});Object.defineProperty(exports,"stringifyFrontmatter",{enumerable:true,get:function(){return e.stringifyFrontmatter}});
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.stringifyFrontmatter=void 0;exports.parseFrontmatter=a;const e=require("@crewx/knowledge-core");Object.defineProperty(exports,"stringifyFrontmatter",{enumerable:true,get:function(){return e.stringifyFrontmatter}});const n="Invalid memory frontmatter YAML";function a(o){let r;try{r=(0,e.parseFrontmatter)(o)}catch(t){if(t instanceof Error&&t.name==="YAMLException"){throw new Error(n)}throw t}if(r.data===null||typeof r.data!=="object"||Array.isArray(r.data)){throw new Error(n)}return r}

package/go/native-manifest.json

@@ -0,0 +1,27 @@
+{
+  "formatVersion": 1,
+  "protocol": 1,
+  "packageVersion": "0.1.23-rc.255",
+  "targets": {
+    "darwin-arm64": {
+      "file": "go/bin/crewx-memory-darwin-arm64",
+      "sha256": "05ecd7e26efd3635775f207bdded79aa684447c77b4615d96d6fc801d989b980"
+    },
+    "darwin-amd64": {
+      "file": "go/bin/crewx-memory-darwin-amd64",
+      "sha256": "e0f3d4f631d92d74e38531fb9c86e4323db1aa5aa34fa0b963026fa96e247e94"
+    },
+    "linux-amd64": {
+      "file": "go/bin/crewx-memory-linux-amd64",
+      "sha256": "48f119e755110dcef59b665f33bc7ac93d362ff7316b71a0e88189021111778a"
+    },
+    "linux-arm64": {
+      "file": "go/bin/crewx-memory-linux-arm64",
+      "sha256": "dcc883fee12f6b26adfbdbfba905e1ab8eaeb41c0320c85180c13a5996c54596"
+    },
+    "windows-amd64": {
+      "file": "go/bin/crewx-memory-windows-amd64.exe",
+      "sha256": "2f6bfb5714384d5b960d1ec6cfefb2b488444974ec9097008a5c6174798657f8"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crewx/memory",
-  "version": "0.1.23-rc.254",
+  "version": "0.1.23-rc.255",
   "description": "Memory engine for CrewX - markdown + frontmatter based long-term memory",
   "type": "commonjs",
   "main": "dist/src/engine.js",
@@ -23,7 +23,9 @@
   },
   "files": [
     "dist",
-    "SKILL.md"
+    "SKILL.md",
+    "go/bin",
+    "go/native-manifest.json"
   ],
   "keywords": [
     "crewx",
@@ -36,9 +38,9 @@
     "gray-matter": "^4.0.3",
     "js-yaml": "^4.1.0",
     "nanoid": "^3.3.11",
-    "@crewx/sdk": "0.9.0-rc.236",
-    "@crewx/shared": "0.0.6-rc.151",
-    "@crewx/knowledge-core": "0.1.17-rc.247"
+    "@crewx/knowledge-core": "0.1.17-rc.248",
+    "@crewx/shared": "0.0.6-rc.152",
+    "@crewx/sdk": "0.9.0-rc.237"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",