create-principles-disciple 1.132.2 → 1.132.4

package/release-manager/dist/update/update-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-history.d.ts","sourceRoot":"","sources":["../../src/update/update-history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,MAAM,WAAW,GACnB,QAAQ,GACR,WAAW,GACX,mBAAmB,GACnB,kBAAkB,GAClB,UAAU,GACV,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;AAE/D,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,YAAY,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAIzC;CACF;AAgBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,IAAI,EAAE,WAAW,CAAC;IAClB,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,2BAA2B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C,GAAG,gBAAgB,CAMnB;AAiBD,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAU3F;AAED,+DAA+D;AAC/D,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA6C/E"}

package/release-manager/dist/update/update-history.js

@@ -0,0 +1,123 @@
+/**
+ * Update history semantics (SPEC §12).
+ *
+ * History events use explicit kinds: update, reinstall, channel_promotion,
+ * legacy_migration, rollback, refusal, and recovery. Direction is DERIVED
+ * from canonical release identity and metadata sequence — never from
+ * package.json values found in a checkout. Every failed or refused event
+ * states what happened, whether the previous release remains active, and
+ * the safest next action.
+ */
+import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readFileSync } from 'node:fs';
+import { dirname } from 'node:path';
+export class UpdateHistoryError extends Error {
+    field;
+    constructor(field, message) {
+        super(message);
+        this.name = 'UpdateHistoryError';
+        this.field = field;
+    }
+}
+const HISTORY_KINDS = new Set([
+    'update', 'reinstall', 'channel_promotion', 'legacy_migration', 'rollback', 'refusal', 'recovery',
+]);
+const HISTORY_DIRECTIONS = new Set(['forward', 'backward', 'none']);
+const HISTORY_OUTCOMES = new Set(['succeeded', 'refused', 'failed', 'recovered']);
+const isHistoryKind = (value) => HISTORY_KINDS.has(value);
+const isHistoryDirection = (value) => HISTORY_DIRECTIONS.has(value);
+const isHistoryOutcome = (value) => HISTORY_OUTCOMES.has(value);
+/**
+ * Direction is derived from canonical publication sequences: forward when the
+ * event's release is newer than the previous one, backward when older,
+ * none for reinstall/refusal/unknown.
+ */
+export function classifyDirection(input) {
+    if (input.kind === 'reinstall' || input.kind === 'refusal')
+        return 'none';
+    if (input.releasePublicationSequence === null || input.previousPublicationSequence === null)
+        return 'none';
+    if (input.releasePublicationSequence > input.previousPublicationSequence)
+        return 'forward';
+    if (input.releasePublicationSequence < input.previousPublicationSequence)
+        return 'backward';
+    return 'none';
+}
+function validateEvent(event) {
+    if (!HISTORY_KINDS.has(event.kind)) {
+        throw new UpdateHistoryError('kind', `Unknown history kind: ${JSON.stringify(event.kind)}`);
+    }
+    if (!/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?Z$/.test(event.at)) {
+        throw new UpdateHistoryError('at', `History event timestamps must be RFC3339 UTC: ${JSON.stringify(event.at)}`);
+    }
+    if (event.outcome !== 'succeeded' && event.outcome !== 'refused' && event.outcome !== 'failed' && event.outcome !== 'recovered') {
+        throw new UpdateHistoryError('outcome', `Unknown history outcome: ${JSON.stringify(event.outcome)}`);
+    }
+    if (event.outcome !== 'succeeded' && event.nextAction === null) {
+        throw new UpdateHistoryError('nextAction', `A ${event.outcome} history event must carry a next action (rc-9).`);
+    }
+}
+/** Appends one durable history event to `<pdHome>/logs/history.jsonl`. */
+export function appendHistoryEvent(historyFilePath, event) {
+    validateEvent(event);
+    mkdirSync(dirname(historyFilePath), { recursive: true });
+    let descriptor;
+    try {
+        descriptor = openSync(historyFilePath, 'a');
+        appendFileSync(descriptor, `${JSON.stringify(event)}\n`);
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+/** Strict reader for tests and the Console history surface. */
+export function readHistoryEvents(historyFilePath) {
+    if (!existsSync(historyFilePath))
+        return [];
+    const raw = readFileSync(historyFilePath, 'utf8');
+    const events = [];
+    for (const line of raw.split('\n')) {
+        if (line.trim().length === 0)
+            continue;
+        const parsed = JSON.parse(line);
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            throw new UpdateHistoryError('line', 'history lines must be objects');
+        }
+        const read = (field) => Reflect.get(parsed, field);
+        const fail = (field, value) => {
+            throw new UpdateHistoryError('line', `history field "${field}" has invalid type: ${JSON.stringify(value)}`);
+        };
+        const requireString = (field) => {
+            const value = read(field);
+            return typeof value === 'string' ? value : fail(field, value);
+        };
+        const stringOrNull = (field) => {
+            const value = read(field);
+            if (value === null || value === undefined)
+                return null;
+            return typeof value === 'string' ? value : fail(field, value);
+        };
+        // Enum fields are narrowed through their closed vocabularies before
+        // construction; validateEvent below re-checks cross-field contracts.
+        const kindValue = requireString('kind');
+        const directionValue = requireString('direction');
+        const outcomeValue = requireString('outcome');
+        const event = {
+            at: requireString('at'),
+            kind: isHistoryKind(kindValue) ? kindValue : fail('kind', kindValue),
+            direction: isHistoryDirection(directionValue) ? directionValue : fail('direction', directionValue),
+            outcome: isHistoryOutcome(outcomeValue) ? outcomeValue : fail('outcome', outcomeValue),
+            productVersion: stringOrNull('productVersion'),
+            releaseId: stringOrNull('releaseId'),
+            previousReleaseId: stringOrNull('previousReleaseId'),
+            previousRemainsActive: read('previousRemainsActive') === true,
+            reason: stringOrNull('reason'),
+            nextAction: stringOrNull('nextAction'),
+            transactionId: stringOrNull('transactionId'),
+        };
+        validateEvent(event);
+        events.push(event);
+    }
+    return events;
+}
+//# sourceMappingURL=update-history.js.map

package/release-manager/dist/update/update-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-history.js","sourceRoot":"","sources":["../../src/update/update-history.ts"],"names":[],"mappings":"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"}

package/release-manager/dist/utils/config-file-io.d.ts

@@ -0,0 +1,26 @@
+import * as fs from 'node:fs';
+export interface ConfigFileOps {
+    mkdtempSync: typeof fs.mkdtempSync;
+    openSync: typeof fs.openSync;
+    writeFileSync: typeof fs.writeFileSync;
+    writeSync: typeof fs.writeSync;
+    fsyncSync: typeof fs.fsyncSync;
+    closeSync: typeof fs.closeSync;
+    renameSync: typeof fs.renameSync;
+    unlinkSync: typeof fs.unlinkSync;
+    rmdirSync: typeof fs.rmdirSync;
+    readFileSync: typeof fs.readFileSync;
+    existsSync: typeof fs.existsSync;
+}
+/** Extract a POSIX errno code (EPERM/EACCES/ENOENT/...) from a thrown fs error. */
+export declare function errnoCode(value: unknown): string | undefined;
+/** Same-directory, flushed temp write followed by atomic replacement. */
+export declare function atomicReplaceTextFile(filePath: string, content: string, ops?: ConfigFileOps): void;
+export interface ConfigFileLockOptions {
+    ops?: ConfigFileOps;
+    maxAttempts?: number;
+    sleep?: (milliseconds: number) => void;
+}
+/** Cross-process O_EXCL lock following the project's Runtime V2 lock convention. */
+export declare function withConfigFileLock<T>(filePath: string, action: () => T, options?: ConfigFileLockOptions): T;
+//# sourceMappingURL=config-file-io.d.ts.map

package/release-manager/dist/utils/config-file-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file-io.d.ts","sourceRoot":"","sources":["../../src/utils/config-file-io.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC;IAC7B,aAAa,EAAE,OAAO,EAAE,CAAC,aAAa,CAAC;IACvC,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC/B,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC/B,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC/B,UAAU,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC;IACjC,UAAU,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC;IACjC,SAAS,EAAE,OAAO,EAAE,CAAC,SAAS,CAAC;IAC/B,YAAY,EAAE,OAAO,EAAE,CAAC,YAAY,CAAC;IACrC,UAAU,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC;CAClC;AAID,mFAAmF;AACnF,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAI5D;AAED,yEAAyE;AACzE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,aAAwB,GAAG,IAAI,CAkC5G;AAgBD,MAAM,WAAW,qBAAqB;IACpC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,CAAC,EAClC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,CAAC,EACf,OAAO,GAAE,qBAA0B,GAClC,CAAC,CAyCH"}

package/release-manager/dist/utils/config-file-io.js

@@ -0,0 +1,128 @@
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+const FILE_OPS = fs;
+/** Extract a POSIX errno code (EPERM/EACCES/ENOENT/...) from a thrown fs error. */
+export function errnoCode(value) {
+    if (typeof value !== 'object' || value === null || !Object.hasOwn(value, 'code'))
+        return undefined;
+    const { code } = value;
+    return typeof code === 'string' ? code : undefined;
+}
+/** Same-directory, flushed temp write followed by atomic replacement. */
+export function atomicReplaceTextFile(filePath, content, ops = FILE_OPS) {
+    const tempDir = ops.mkdtempSync(path.join(path.dirname(filePath), '.pd-config-write-'));
+    const tempPath = path.join(tempDir, 'config.yaml');
+    let fd;
+    let replaced = false;
+    let operationError;
+    try {
+        fd = ops.openSync(tempPath, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL, 0o600);
+        ops.writeFileSync(fd, content, 'utf8');
+        ops.fsyncSync(fd);
+        ops.closeSync(fd);
+        fd = undefined;
+        ops.renameSync(tempPath, filePath);
+        replaced = true;
+    }
+    catch (error) {
+        operationError = error;
+    }
+    let cleanupError;
+    if (fd !== undefined) {
+        try {
+            ops.closeSync(fd);
+        }
+        catch (error) {
+            cleanupError = error;
+        }
+    }
+    if (!replaced && ops.existsSync(tempPath)) {
+        try {
+            ops.unlinkSync(tempPath);
+        }
+        catch (error) {
+            cleanupError ??= error;
+        }
+    }
+    if (ops.existsSync(tempDir)) {
+        try {
+            ops.rmdirSync(tempDir);
+        }
+        catch (error) {
+            cleanupError ??= error;
+        }
+    }
+    if (operationError !== undefined && cleanupError !== undefined) {
+        throw new AggregateError([operationError, cleanupError], 'Atomic config replacement and cleanup both failed');
+    }
+    if (operationError !== undefined)
+        throw operationError instanceof Error ? operationError : new Error(String(operationError));
+    if (cleanupError !== undefined)
+        throw cleanupError instanceof Error ? cleanupError : new Error(String(cleanupError));
+}
+function sleepSync(milliseconds) {
+    if (milliseconds <= 0)
+        return;
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, milliseconds);
+}
+function readLockPid(lockPath, ops) {
+    try {
+        const value = Number.parseInt(ops.readFileSync(lockPath, 'utf8').trim(), 10);
+        return Number.isNaN(value) ? null : value;
+    }
+    catch {
+        return null;
+    }
+}
+/** Cross-process O_EXCL lock following the project's Runtime V2 lock convention. */
+export function withConfigFileLock(filePath, action, options = {}) {
+    const ops = options.ops ?? FILE_OPS;
+    const lockPath = `${filePath}.lock`;
+    const maxAttempts = options.maxAttempts ?? 50;
+    const wait = options.sleep ?? sleepSync;
+    let acquired = false;
+    for (let attempt = 0; attempt < maxAttempts && !acquired; attempt += 1) {
+        let lockFd;
+        try {
+            lockFd = ops.openSync(lockPath, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL, 0o600);
+            ops.writeSync(lockFd, String(process.pid));
+            ops.fsyncSync(lockFd);
+            ops.closeSync(lockFd);
+            lockFd = undefined;
+            acquired = true;
+        }
+        catch (error) {
+            if (lockFd !== undefined) {
+                try {
+                    ops.closeSync(lockFd);
+                }
+                catch { /* preserve the acquisition error */ }
+                try {
+                    ops.unlinkSync(lockPath);
+                }
+                catch { /* preserve the acquisition error */ }
+            }
+            if (errnoCode(error) !== 'EEXIST')
+                throw error;
+            // Ownership rule: EEXIST never authorizes deletion. PID/age metadata may
+            // be stale or malformed, but only the creator may remove this lock.
+            if (attempt < maxAttempts - 1) {
+                wait(Math.min(10 * 2 ** attempt, 500));
+            }
+        }
+    }
+    if (!acquired) {
+        const holderPid = readLockPid(lockPath, ops);
+        const holder = holderPid === null ? 'unknown' : `PID ${holderPid}`;
+        throw new Error(`Failed to acquire config lock ${lockPath}; holder ${holder}; ` +
+            'nextAction=remove the lock manually only after verifying no installer is active');
+    }
+    try {
+        return action();
+    }
+    finally {
+        if (readLockPid(lockPath, ops) === process.pid)
+            ops.unlinkSync(lockPath);
+    }
+}
+//# sourceMappingURL=config-file-io.js.map

package/release-manager/dist/utils/config-file-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-file-io.js","sourceRoot":"","sources":["../../src/utils/config-file-io.ts"],"names":[],"mappings":"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"}

package/release-manager/dist/utils/env.d.ts

@@ -0,0 +1,60 @@
+export interface EnvCheckResult {
+    hasOpenClaw: boolean;
+    openclawVersion?: string;
+    hasNode: boolean;
+    nodeVersion?: string;
+    isNodeSupported: boolean;
+    hasPython: boolean;
+    pythonVersion?: string;
+    hasGit: boolean;
+}
+export interface WorkspaceInfo {
+    detectedPath: string;
+    exists: boolean;
+    hasPrinciples: boolean;
+    isFirstInstall: boolean;
+    coreFiles: string[];
+}
+/**
+ * 检测运行环境
+ */
+export declare function checkEnvironment(): EnvCheckResult;
+/**
+ * 检测 OpenClaw 工作区
+ */
+export declare function detectWorkspace(): WorkspaceInfo;
+/**
+ * 获取 OpenClaw 配置目录
+ */
+export declare function getOpenClawConfigDir(): string;
+/**
+ * 获取插件扩展目录
+ */
+export declare function getPluginExtDir(): string;
+export interface OpenClawGatewayStatus {
+    isRunning: boolean;
+    port?: number;
+    pid?: number;
+}
+/**
+ * 从 netstat -ano -p tcp 输出解析监听指定端口的 PID。
+ * 行形如：TCP  0.0.0.0:135  0.0.0.0:0  LISTENING  1234（IPv6 本地地址为 [::]:port）。
+ * rc-1/rc-5: 按 unknown 语义逐字段校验，键/列缺失即跳过，不信任列位置。
+ */
+export declare function parseNetstatPid(output: string, port: number): number | undefined;
+export declare function checkOpenClawGateway(): Promise<OpenClawGatewayStatus>;
+export interface GatewayControlResult {
+    ok: boolean;
+    error?: string;
+}
+/**
+ * Stop the OpenClaw gateway service. Call before mutating the plugin ext dir
+ * to release file locks held on native modules (EPERM on backup rename).
+ */
+export declare function stopOpenClawGateway(): Promise<GatewayControlResult>;
+/**
+ * Start the OpenClaw gateway service (inverse of stopOpenClawGateway). Called
+ * after install completes (success or failure) to leave the gateway running.
+ */
+export declare function restartOpenClawGateway(): Promise<GatewayControlResult>;
+//# sourceMappingURL=env.d.ts.map

package/release-manager/dist/utils/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/utils/env.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,OAAO,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,OAAO,CAAC;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,OAAO,CAAC;IACvB,cAAc,EAAE,OAAO,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAoBD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,cAAc,CA+DjD;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,aAAa,CA4D/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA+BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBhF;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,qBAAqB,CAAC,CAmC3E;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiCD;;;GAGG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAEzE;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAE5E"}