@mplp/integration-storage-fs 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+This package follows the global MPLP Protocol changelog.
+
+See: https://github.com/coregentis/MPLP-Protocol/blob/main/CHANGELOG.md

package/README.md

@@ -0,0 +1,61 @@
+# @mplp/integration-storage-fs
+
+**Protocol:** MPLP v1.0.0 (Frozen)
+**License:** Apache-2.0
+
+The **@mplp/integration-storage-fs** package provides **Filesystem storage integration** for the
+**Multi-Agent Lifecycle Protocol (MPLP)** — the Agent OS–level lifecycle specification for AI agent systems.
+
+---
+
+## Scope & Guarantees (Important)
+
+### ✅ What this package provides
+
+* **Protocol-compliant interfaces** aligned with MPLP v1.0.0
+* **Strict version alignment** with the frozen MPLP protocol specification
+* **Type-safe integration surface** for higher-level runtimes and tools
+
+### ❌ What this package does NOT provide
+
+* ❌ Full execution runtime (LLM orchestration, tool execution)
+* ❌ Golden Flow execution engines (Flow-01 ~ Flow-05)
+* ❌ Observability pipelines or distributed tracing backends
+* ❌ Production agent orchestration
+
+> These capabilities belong to **reference runtimes and products built *on top of* MPLP**,
+> not to the protocol SDK itself.
+
+---
+
+## Installation
+
+```bash
+npm install @mplp/integration-storage-fs
+```
+
+---
+
+## Protocol Documentation (Authoritative)
+
+* **Homepage:** [https://mplp.io](https://mplp.io)
+* **Specification & Docs:** [https://docs.mplp.io](https://docs.mplp.io)
+* **Source Repository:** [https://github.com/Coregentis/MPLP-Protocol](https://github.com/Coregentis/MPLP-Protocol)
+* **Issues:** [https://github.com/Coregentis/MPLP-Protocol/issues](https://github.com/Coregentis/MPLP-Protocol/issues)
+
+---
+
+## Versioning & Compatibility
+
+* **Protocol version:** MPLP v1.0.0 (Frozen)
+* **SDK compatibility:** Guaranteed for v1.0.0 only
+* Breaking changes require a new protocol version.
+
+---
+
+## License
+
+Apache License, Version 2.0
+
+© 2025 **Bangshi Beijing Network Technology Limited Company**
+Coregentis AI

package/dist/fs-storage.d.ts

@@ -1,14 +1,3 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
 export interface FsStorageConfig {
     baseDir: string;
 }

package/dist/fs-storage.js

@@ -1,17 +1,13 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonFsStorage = void 0;
 /**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
  *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.JsonFsStorage = void 0;
 const fs_1 = require("fs");
 const path_1 = require("path");
 class JsonFsStorage {

package/dist/index.d.ts

@@ -1,12 +1,8 @@
 /**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
  *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
  */
 export * from "./fs-storage";

package/dist/index.js

@@ -1,15 +1,4 @@
 "use strict";
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -25,4 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
+ *
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
+ */
 __exportStar(require("./fs-storage"), exports);

package/package.json

@@ -1,12 +1,11 @@
 {
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
   "name": "@mplp/integration-storage-fs",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "File system storage integration for MPLP",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "dependencies": {
-    "@mplp/core": "1.0.1"
+    "@mplp/core": "^1.0.2"
   },
   "devDependencies": {
     "typescript": "^5.0.0",
@@ -17,11 +16,36 @@
     "access": "public"
   },
   "mplp": {
-    "module": "integration-storage-fs",
-    "layer": "L3-Integration",
-    "status": "stable",
-    "governance": "MPGC"
+    "protocolVersion": "1.0.0",
+    "frozen": true,
+    "governance": "MPGC",
+    "layer": "L4"
   },
+  "author": "Coregentis AI",
+  "copyright": "© 2025 邦士（北京）网络科技有限公司",
+  "license": "Apache-2.0",
+  "homepage": "https://mplp.io",
+  "bugs": {
+    "url": "https://github.com/Coregentis/MPLP-Protocol/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Coregentis/MPLP-Protocol.git"
+  },
+  "keywords": [
+    "mplp",
+    "multi-agent",
+    "protocol",
+    "lifecycle",
+    "agent-os"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "sideEffects": false,
   "scripts": {
     "build": "tsc -p tsconfig.json",
     "test": "vitest run"

package/src/fs-storage.ts

@@ -1,15 +1,10 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
+/**
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
+ *
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
+ */
 import { promises as fs } from "fs";
 import { join } from "path";
 

package/src/index.ts

@@ -1,13 +1,8 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
+/**
+ * © 2025 邦士（北京）网络科技有限公司
+ * Licensed under the Apache License, Version 2.0.
+ *
+ * This file is part of the MPLP reference implementation.
+ * It is NOT part of the frozen protocol specification.
+ */
 export * from "./fs-storage";

package/tests/fs-storage.test.ts

@@ -1,15 +1,15 @@
-/**
- * MPLP Protocol v1.0.0 — Frozen Specification
- * Freeze Date: 2025-12-03
- * Status: FROZEN (no breaking changes permitted)
- * Governance: MPLP Protocol Governance Committee (MPGC)
- *
- * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * http://www.apache.org/licenses/LICENSE-2.0
- */
-
+/**
+ * MPLP Protocol v1.0.0 — Frozen Specification
+ * Freeze Date: 2025-12-03
+ * Status: FROZEN (no breaking changes permitted)
+ * Governance: MPLP Protocol Governance Committee (MPGC)
+ *
+ * © 2025 邦士（北京）网络科技有限公司. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * http://www.apache.org/licenses/LICENSE-2.0
+ */
+
 import { describe, it, expect, afterEach } from "vitest";
 import { JsonFsStorage } from "../src/fs-storage";
 import { promises as fs } from "fs";

package/tsconfig.json

@@ -1,11 +1,11 @@
-{
-  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
-  "extends": "../../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": [
-    "src"
-  ]
-}
+{
+  "$comment": "MPLP Protocol v1.0.0 — Frozen Specification\nFreeze Date: 2025-12-03\nStatus: FROZEN (no breaking changes permitted)\nGovernance: MPLP Protocol Governance Committee (MPGC)\nCopyright: © 2025 邦士（北京）网络科技有限公司\nLicense: Apache-2.0\nAny normative change requires a new protocol version.",
+  "extends": "../../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": [
+    "src"
+  ]
+}