@maolon/pi-watcher 0.0.0-stage → 0.1.0

package/dist/util/result.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Standard tool/service result envelope and error codes (design 11.4).
+ */
+export type WatcherErrorCode = 'INVALID_SPEC' | 'STALE_REVISION' | 'UNKNOWN_TARGET' | 'CAPABILITY_DENIED' | 'SOURCE_UNAVAILABLE' | 'BUDGET_EXHAUSTED' | 'STORE_UNAVAILABLE' | 'ADMISSION_UNKNOWN' | 'DEPENDENCY_UNQUALIFIED' | 'ROOT_LOCK_HELD' | 'NO_DELIVERY' | 'REQUEST_CONFLICT';
+export declare class WatcherError extends Error {
+    readonly code: WatcherErrorCode;
+    readonly exitCode: number;
+    constructor(code: WatcherErrorCode, message: string);
+}
+export interface OkResult<T> {
+    ok: true;
+    requestId?: string;
+    value: T;
+}
+export interface ErrResult {
+    ok: false;
+    requestId?: string;
+    error: {
+        code: WatcherErrorCode;
+        message: string;
+    };
+}
+export type ServiceResult<T> = OkResult<T> | ErrResult;
+export declare function ok<T>(value: T, requestId?: string): OkResult<T>;
+export declare function err(code: WatcherErrorCode, message: string, requestId?: string): ErrResult;
+export declare function toServiceResult<T>(requestId: string | undefined, fn: () => T): ServiceResult<T>;
+/** Async version: fn may be async; a thrown error object may carry a code field (lightweight tool-layer error). */
+export declare function toServiceResultAsync<T>(requestId: string | undefined, fn: () => Promise<T> | T): Promise<ServiceResult<T>>;

package/dist/util/result.js

@@ -0,0 +1,54 @@
+/**
+ * Standard tool/service result envelope and error codes (design 11.4).
+ */
+export class WatcherError extends Error {
+    code;
+    exitCode;
+    constructor(code, message) {
+        super(message);
+        this.name = 'WatcherError';
+        this.code = code;
+        // CLI exit code mapping (design 11.4): 2 invalid input; 3 permission/qualification; 4 delivery unknown; 5 local dependency/storage
+        this.exitCode =
+            code === 'INVALID_SPEC' || code === 'UNKNOWN_TARGET' ? 2
+                : code === 'ADMISSION_UNKNOWN' ? 4
+                    : code === 'STORE_UNAVAILABLE' || code === 'ROOT_LOCK_HELD' ? 5
+                        : 3;
+    }
+}
+export function ok(value, requestId) {
+    return { ok: true, requestId, value };
+}
+export function err(code, message, requestId) {
+    return { ok: false, requestId, error: { code, message } };
+}
+export function toServiceResult(requestId, fn) {
+    try {
+        return ok(fn(), requestId);
+    }
+    catch (e) {
+        if (e instanceof WatcherError) {
+            return err(e.code, e.message, requestId);
+        }
+        const message = e instanceof Error ? e.message : String(e);
+        return err('STORE_UNAVAILABLE', `unexpected failure: ${message}`, requestId);
+    }
+}
+/** Async version: fn may be async; a thrown error object may carry a code field (lightweight tool-layer error). */
+export async function toServiceResultAsync(requestId, fn) {
+    try {
+        const value = await fn();
+        return ok(value, requestId);
+    }
+    catch (e) {
+        if (e instanceof WatcherError) {
+            return err(e.code, e.message, requestId);
+        }
+        const anyE = e;
+        if (typeof anyE?.code === 'string') {
+            return err(anyE.code, anyE.message ?? 'error', requestId);
+        }
+        const message = e instanceof Error ? e.message : String(e);
+        return err('STORE_UNAVAILABLE', `unexpected failure: ${message}`, requestId);
+    }
+}

package/package.json

@@ -1,6 +1,103 @@
 {
   "name": "@maolon/pi-watcher",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Watch long-running Pi tasks without babysitting: deterministic task monitoring, optional semantic review, and relay-delivered wakes only when something needs the host.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-coding-agent",
+    "watcher",
+    "monitoring",
+    "long-running-tasks",
+    "agents"
+  ],
+  "homepage": "https://github.com/Maolon/pi-watcher#readme",
+  "bugs": {
+    "url": "https://github.com/Maolon/pi-watcher/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Maolon/pi-watcher.git"
+  },
+  "license": "MIT",
+  "author": "Maolon",
+  "type": "module",
+  "main": "./dist/pi-extension.js",
+  "types": "./dist/pi-extension.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/pi-extension.d.ts",
+      "import": "./dist/pi-extension.js",
+      "default": "./dist/pi-extension.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "pi-watcher": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./dist/pi-extension.js"
+    ]
+  },
+  "engines": {
+    "node": ">=22.16.0"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "tsx --test tests/jev/*.test.ts tests/storage/*.test.ts tests/source/*.test.ts tests/relay/*.test.ts tests/engine/*.test.ts tests/*.test.ts",
+    "test:unit": "tsx --test tests/storage/*.test.ts tests/source/*.test.ts tests/relay/*.test.ts tests/engine/*.test.ts",
+    "test:jev": "tsx --test tests/jev/*.test.ts",
+    "test:jev:unit": "tsx --test tests/jev/sanitizer.test.ts tests/jev/mock-judge.test.ts tests/jev/client-unit.test.ts tests/jev/pi-registry.test.ts",
+    "test:jev:live": "tsx --test tests/jev/client-live.test.ts",
+    "test:package": "node scripts/package-smoke.mjs",
+    "qualify": "tsx src/cli.ts qualify",
+    "doctor": "tsx src/cli.ts doctor",
+    "demo": "tsx src/cli.ts demo",
+    "prepublishOnly": "npm run typecheck && npm run build && npm run test:package"
+  },
+  "dependencies": {
+    "@maolon/pi-relay": "^0.2.0",
+    "better-sqlite3": "13.0.3",
+    "fs-ext": "2.1.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^9.6.0",
+    "@types/node": "^22.20.4",
+    "tsx": "^4.23.13",
+    "typebox": "^1.3.34",
+    "typescript": "^5.7.3"
+  },
+  "allowScripts": {
+    "better-sqlite3@13.0.3": true
+  }
+}