@coralai/sps-plugin-api 0.15.0 → 0.16.0

package/dist/index.d.ts

@@ -406,6 +406,13 @@ export interface SpsWorkspace {
      */
     declaredOutDir(repoDir: string): string | null | undefined;
 }
+export type SyncRejectCode = 'EMPTY_SEGMENT' | 'ABSOLUTE' | 'PARENT_SEGMENT' | 'DOT_SEGMENT';
+export interface SyncRejection {
+    code: SyncRejectCode;
+    rel: string;
+}
+/** 相对路径的形状判据。返回 `null` = 形状没问题(**不代表可同步**,还要过软链围栏)。 */
+export declare function syncableShape(rel: string): SyncRejection | null;
 /**
  * `p` 是否在 `root` 之内(含 root 自身)。
  *

package/dist/index.js

@@ -13,6 +13,23 @@
  */
 import { realpath } from 'node:fs/promises';
 import { dirname, join, resolve as nodeResolve, sep } from 'node:path';
+/** 相对路径的形状判据。返回 `null` = 形状没问题(**不代表可同步**,还要过软链围栏)。 */
+export function syncableShape(rel) {
+    if (!rel)
+        return { code: 'EMPTY_SEGMENT', rel };
+    if (rel.startsWith('/'))
+        return { code: 'ABSOLUTE', rel };
+    for (const seg of rel.split('/')) {
+        if (!seg)
+            return { code: 'EMPTY_SEGMENT', rel };
+        if (seg === '..')
+            return { code: 'PARENT_SEGMENT', rel };
+        // ← 承重的是这条:`.claude/`、`.git/`、`.sps/` 全靠它
+        if (seg.startsWith('.'))
+            return { code: 'DOT_SEGMENT', rel };
+    }
+    return null;
+}
 // ── 路径围栏:所有插件共用的安全下限 ──────────────────────────────────────
 //
 // 🔴 **安全判据不能有第二份。** 本仓已经为这个形状付过三次代价:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coralai/sps-plugin-api",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "sps 宿主半区的插件契约:ctx 上那些服务的方法签名。插件装它拿类型。",
   "type": "module",
   "main": "./dist/index.js",