jishushell 0.6.5 → 0.7.3

package/dist/services/legacy-migrator/classifier.d.ts

@@ -0,0 +1,44 @@
+/**
+ * legacy-migrator/classifier.ts
+ *
+ * Decide whether a discovered legacy instance directory can be migrated to
+ * the current Core's canonical layout. The classifier is the single source
+ * of truth for "what counts as official builtin" and "what counts as
+ * unsupported" — runtime code must not duplicate this logic.
+ *
+ * Hard rules (per docs/core-app-architecture.md §15):
+ *   - Only official builtin AppDefinition instances are migratable.
+ *   - custom / user-defined / process-manager / host-mode → unsupported.
+ *   - Unknown / corrupted / no-spec-derivable → unsupported.
+ *
+ * This file is the only allowed reader of legacy discriminators
+ * (`agentType`, `app_type`, `app_spec_ref`, marker env vars / files).
+ * Runtime hot path must use canonical `integrations[].kind` / definition
+ * metadata exclusively.
+ */
+import type { LegacyInstanceRecord, OfficialBuiltinId, UnsupportedReason } from "./types.js";
+/**
+ * Classification result.
+ *
+ * - `migratable` with `builtinId`: the migrator can rewrite metadata using
+ *   that official builtin's AppDefinition and move the directory.
+ * - `unsupported`: the migrator must record the reason and skip — runtime
+ *   must refuse to operate on this instance.
+ */
+export interface ClassificationResult {
+    classification: "migratable" | "migrated" | "unsupported";
+    builtinId?: OfficialBuiltinId;
+    preserveCanonicalSpec?: boolean;
+    unsupportedReason?: UnsupportedReason;
+    detail: string;
+}
+/**
+ * Detect whether the directory already conforms to the canonical layout.
+ * Integration dispatch is represented by optional `integrations[].kind`;
+ * generic AppSpec instances legitimately have no integration entry.
+ */
+export declare function isAlreadyCanonical(record: LegacyInstanceRecord): boolean;
+export declare function classifyLegacyInstance(record: LegacyInstanceRecord, options?: {
+    specSnapshotId?: string | null;
+}): ClassificationResult;
+export declare function isOfficialBuiltinId(id: string): id is OfficialBuiltinId;

package/dist/services/legacy-migrator/classifier.js

@@ -0,0 +1,309 @@
+/**
+ * legacy-migrator/classifier.ts
+ *
+ * Decide whether a discovered legacy instance directory can be migrated to
+ * the current Core's canonical layout. The classifier is the single source
+ * of truth for "what counts as official builtin" and "what counts as
+ * unsupported" — runtime code must not duplicate this logic.
+ *
+ * Hard rules (per docs/core-app-architecture.md §15):
+ *   - Only official builtin AppDefinition instances are migratable.
+ *   - custom / user-defined / process-manager / host-mode → unsupported.
+ *   - Unknown / corrupted / no-spec-derivable → unsupported.
+ *
+ * This file is the only allowed reader of legacy discriminators
+ * (`agentType`, `app_type`, `app_spec_ref`, marker env vars / files).
+ * Runtime hot path must use canonical `integrations[].kind` / definition
+ * metadata exclusively.
+ */
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { APP_INSTANCE_SCHEMA_VERSION, readCanonicalInstance, readCanonicalManifestFromDir, } from "../app-common/instance-store.js";
+const OFFICIAL_BUILTIN_IDS = new Set([
+    "openclaw-container",
+    "openclaw-binary",
+    "openclaw-with-ollama-container",
+    "openclaw-with-searxng-container",
+    "hermes-container",
+    "ollama-binary",
+    "ollama-cpu-docker",
+    "ollama-with-hollama-binary",
+    "searxng-container",
+    "browserless-chromium-container",
+    "filebrowser-container",
+    "weknora-container",
+    "jishu-kb-container",
+    "anythingllm-container",
+]);
+const DEFAULT_BUILTIN_BY_AGENT_KIND = {
+    openclaw: "openclaw-container",
+    hermes: "hermes-container",
+    ollama: "ollama-cpu-docker",
+};
+function nonEmptyString(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function isOfficialBuiltin(id) {
+    return OFFICIAL_BUILTIN_IDS.has(id);
+}
+function hasIntegrationRef(meta) {
+    return Array.isArray(meta.integrations) && meta.integrations.length > 0;
+}
+function hasCanonicalRuntimeHostPorts(meta) {
+    const ports = Array.isArray(meta.runtime?.ports) ? meta.runtime.ports : [];
+    return ports.some((port) => Number.isInteger(port?.hostPort)
+        && port.hostPort > 0
+        && Number.isInteger(port?.containerPort)
+        && port.containerPort > 0);
+}
+function looksLikeOfficialAgentKind(kind) {
+    return kind === "openclaw" || kind === "hermes" || kind === "ollama";
+}
+/**
+ * Detect whether the directory already conforms to the canonical layout.
+ * Integration dispatch is represented by optional `integrations[].kind`;
+ * generic AppSpec instances legitimately have no integration entry.
+ */
+export function isAlreadyCanonical(record) {
+    if (record.legacyRoot)
+        return false;
+    const dir = record.sourceDir;
+    if (!existsSync(join(dir, "instance.json")))
+        return false;
+    if (!existsSync(join(dir, "manifest.json")))
+        return false;
+    if (!existsSync(join(dir, "definition.yaml")))
+        return false;
+    if (!existsSync(join(dir, "resolved-spec.yaml")))
+        return false;
+    const meta = record.rawMeta ?? {};
+    if (meta.schemaVersion !== APP_INSTANCE_SCHEMA_VERSION)
+        return false;
+    if (nonEmptyString(meta.id) !== record.id)
+        return false;
+    if (!nonEmptyString(meta?.definition?.id))
+        return false;
+    if (meta.agent != null)
+        return false;
+    if (nonEmptyString(meta.agentType))
+        return false;
+    if (nonEmptyString(meta.app_id))
+        return false;
+    if (nonEmptyString(meta.app_type))
+        return false;
+    if (nonEmptyString(meta.app_spec_ref))
+        return false;
+    if (nonEmptyString(meta.install_mode))
+        return false;
+    if (hasIntegrationRef(meta) && !hasCanonicalRuntimeHostPorts(meta))
+        return false;
+    if (meta.status?.reason === "needs-migration")
+        return false;
+    try {
+        readCanonicalManifestFromDir(dir, record.id);
+        readCanonicalInstance(record.id);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function hasCanonicalInstanceAndSpecShape(record) {
+    if (record.legacyRoot)
+        return false;
+    const meta = record.rawMeta ?? {};
+    return existsSync(join(record.sourceDir, "definition.yaml"))
+        && existsSync(join(record.sourceDir, "resolved-spec.yaml"))
+        && (meta.schemaVersion === 2 || meta.schemaVersion === APP_INSTANCE_SCHEMA_VERSION)
+        && nonEmptyString(meta.id) === record.id
+        && Boolean(nonEmptyString(meta?.definition?.id))
+        && meta.agent == null
+        && !nonEmptyString(meta.agentType)
+        && !nonEmptyString(meta.app_id)
+        && !nonEmptyString(meta.app_type)
+        && !nonEmptyString(meta.app_spec_ref)
+        && !nonEmptyString(meta.install_mode);
+}
+/**
+ * Detect explicit host-mode / process-manager markers — these instances were
+ * supported only by the legacy `process-manager.ts` driver and cannot be
+ * migrated.
+ */
+function hasHostModeMarkers(meta) {
+    const installMode = nonEmptyString(meta.install_mode);
+    if (installMode === "host" || installMode === "host-mode")
+        return "host-mode-openclaw";
+    const runtimeKind = nonEmptyString(meta?.runtime?.kind);
+    if (runtimeKind === "host" || runtimeKind === "process" || runtimeKind === "raw_exec") {
+        return "process-manager-only";
+    }
+    // Bare host binary OpenClaw — the old runtime-adapter path was deleted in
+    // Step 8/9 but old instances may still carry this residue.
+    const openclawBin = nonEmptyString(meta.openclaw_bin);
+    if (openclawBin && !meta?.runtime?.image)
+        return "host-mode-openclaw";
+    return null;
+}
+/**
+ * Detect custom / user-defined / non-builtin instances. We refuse to migrate
+ * anything whose original AppDefinition was not an official builtin shipped
+ * in this Core release.
+ */
+function isCustomOrUserDefined(meta, specSnapshotId) {
+    const agentKind = nonEmptyString(meta?.agent?.kind);
+    const definitionId = nonEmptyString(meta?.definition?.id);
+    if (definitionId && isOfficialBuiltin(definitionId)) {
+        return { custom: false };
+    }
+    const specRef = nonEmptyString(meta.app_spec_ref);
+    if (specRef && isOfficialBuiltin(specRef)) {
+        return { custom: false };
+    }
+    const snapshotId = nonEmptyString(specSnapshotId);
+    if (snapshotId && isOfficialBuiltin(snapshotId)) {
+        return { custom: false };
+    }
+    // Legacy singleton AppSpec installs used the transitional "custom" bridge
+    // while still persisting an official builtin id in app_id/app_spec_ref.
+    // Honor that official evidence before treating the bridge marker as custom.
+    const legacyAppId = nonEmptyString(meta.app_id);
+    if (legacyAppId && isOfficialBuiltin(legacyAppId)) {
+        return { custom: false };
+    }
+    if (looksLikeOfficialAgentKind(agentKind)) {
+        return { custom: false };
+    }
+    const appType = nonEmptyString(meta.app_type);
+    if (appType === "custom" || appType === "user" || appType === "user-defined") {
+        return { custom: true, reason: "custom-or-user-defined-app" };
+    }
+    // `custom` was the transitional integration bridge for generic AppSpec users.
+    // Without official builtin evidence above, refuse it.
+    if (agentKind === "custom")
+        return { custom: true, reason: "custom-or-user-defined-app" };
+    if (legacyAppId && !isOfficialBuiltin(legacyAppId)) {
+        return { custom: true, reason: "custom-or-user-defined-app" };
+    }
+    if (definitionId && !isOfficialBuiltin(definitionId)) {
+        return { custom: true, reason: "custom-or-user-defined-app" };
+    }
+    if (specRef && !isOfficialBuiltin(specRef)) {
+        return { custom: true, reason: "custom-or-user-defined-app" };
+    }
+    return { custom: false };
+}
+/**
+ * Resolve which official builtin AppDefinition should be used to rebuild
+ * canonical metadata for this legacy instance.
+ *
+ * Order of preference:
+ *   1. Explicit `meta.app_id` if it is an official builtin.
+ *   2. Explicit `meta.definition.id` if it is an official builtin.
+ *   3. Explicit `meta.app_spec_ref` if it is an official builtin.
+ *   4. Spec snapshot id (`definition.yaml` / `resolved-spec.yaml` / `app-spec.yaml`)
+ *      if it is an official builtin (read by scanner).
+ *   5. Canonical agent kind mapping (openclaw → openclaw-container, etc.).
+ */
+function resolveBuiltinId(meta, specId) {
+    for (const candidate of [meta.app_id, meta?.definition?.id, meta.app_spec_ref, specId]) {
+        const id = nonEmptyString(candidate);
+        if (id && isOfficialBuiltin(id))
+            return id;
+    }
+    const agentKind = nonEmptyString(meta?.agent?.kind);
+    if (looksLikeOfficialAgentKind(agentKind))
+        return DEFAULT_BUILTIN_BY_AGENT_KIND[agentKind];
+    // Fall back to the legacy mirror fields when the canonical `agent.kind`
+    // is not yet set. The host-mode filter has already excluded `raw_exec` /
+    // OpenClaw-binary cases, so this branch only fires for container-runtime
+    // legacy instances that just lack the canonical agent stamp.
+    const legacyMirror = nonEmptyString(meta.agentType) || nonEmptyString(meta.app_type);
+    const legacyKind = legacyMirror === "hermes-agent" ? "hermes" : legacyMirror;
+    if (looksLikeOfficialAgentKind(legacyKind))
+        return DEFAULT_BUILTIN_BY_AGENT_KIND[legacyKind];
+    return null;
+}
+export function classifyLegacyInstance(record, options = {}) {
+    if (isAlreadyCanonical(record)) {
+        return {
+            classification: "migrated",
+            detail: "Already on canonical layout; no migration required.",
+        };
+    }
+    const meta = record.rawMeta;
+    if (!meta) {
+        if (record.legacyResidueKind === "empty-directory") {
+            return {
+                classification: "unsupported",
+                unsupportedReason: "empty-legacy-residue",
+                detail: `No canonical metadata or preserved integration state remains under ${record.sourceDir}; safe to ignore or delete manually.`,
+            };
+        }
+        if (record.legacyResidueKind === "incomplete-install") {
+            return {
+                classification: "unsupported",
+                unsupportedReason: "incomplete-install",
+                detail: `Install lock is still present under ${record.sourceDir}; wait for the install to finish or retry the app install.`,
+            };
+        }
+        if (record.legacyResidueKind === "openclaw-home") {
+            const builtinId = isOfficialBuiltin(record.builtinId ?? "")
+                ? record.builtinId
+                : "openclaw-container";
+            return {
+                classification: "migratable",
+                builtinId,
+                detail: `Will rebuild canonical metadata from preserved '${record.legacyResidueKind}' state using builtin '${builtinId}'.`,
+            };
+        }
+        return {
+            classification: "unsupported",
+            unsupportedReason: "directory-corrupted",
+            detail: `Cannot read 'instance.json' under ${record.sourceDir}.`,
+        };
+    }
+    if (hasCanonicalInstanceAndSpecShape(record)) {
+        const builtinId = resolveBuiltinId(record.rawMeta ?? {}, options.specSnapshotId ?? null);
+        return {
+            classification: "migratable",
+            preserveCanonicalSpec: true,
+            ...(builtinId ? { builtinId } : {}),
+            detail: "Will preserve canonical instance/spec files and rewrite manifest.json to the current schema.",
+        };
+    }
+    const hostMode = hasHostModeMarkers(meta);
+    if (hostMode) {
+        return {
+            classification: "unsupported",
+            unsupportedReason: hostMode,
+            detail: hostMode === "host-mode-openclaw"
+                ? "OpenClaw host-mode is no longer supported. Reinstall as `openclaw-container` after backing up data."
+                : "Process-manager-only instances are no longer supported. Reinstall using a container-backed builtin.",
+        };
+    }
+    const custom = isCustomOrUserDefined(meta, options.specSnapshotId ?? null);
+    if (custom.custom) {
+        return {
+            classification: "unsupported",
+            unsupportedReason: custom.reason,
+            detail: "Custom / user-defined / non-official builtin instances are not supported in this release.",
+        };
+    }
+    const builtinId = resolveBuiltinId(meta, options.specSnapshotId ?? null);
+    if (!builtinId) {
+        return {
+            classification: "unsupported",
+            unsupportedReason: "no-canonical-spec-derivable",
+            detail: "Cannot determine an official builtin AppDefinition for this instance.",
+        };
+    }
+    return {
+        classification: "migratable",
+        builtinId,
+        detail: `Will rewrite canonical metadata from builtin '${builtinId}'.`,
+    };
+}
+export function isOfficialBuiltinId(id) {
+    return isOfficialBuiltin(id);
+}
+//# sourceMappingURL=classifier.js.map

package/dist/services/legacy-migrator/classifier.js.map

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

package/dist/services/legacy-migrator/executor.d.ts

@@ -0,0 +1,42 @@
+/**
+ * legacy-migrator/executor.ts
+ *
+ * Apply a migration plan to disk. This is the only module in the codebase
+ * allowed to:
+ *
+ *   - Stop a legacy instance via runtime drivers.
+ *   - Rewrite `instance.json` / `manifest.json` / `definition.yaml` /
+ *     `resolved-spec.yaml` from official builtin AppDefinitions.
+ *   - Rename `instances/<id>` → `apps/<id>`.
+ *
+ * Every disruptive step requires the caller to pass `confirm: true`.
+ * Without confirmation the executor refuses to mutate anything.
+ */
+import type { MigrationPlan, MigrationReport } from "./types.js";
+declare const SCHEMA_VERSION = 2;
+declare const MIGRATION_ID = "legacy-migrator-step-13";
+export interface ExecuteOptions {
+    /**
+     * Must be `true` to actually mutate files. When `false` the executor
+     * returns a dry-run report identical in shape to the real one — the
+     * "migrated" entries report "failed" with the refused-without-confirm
+     * error so callers never accidentally rely on a no-op pass.
+     */
+    confirm: boolean;
+    /**
+     * When `true`, only entries whose `classification === "migratable"` are
+     * processed; "migrated" stay as `skipped-already-migrated` and
+     * "unsupported" stay as `unsupported`.
+     */
+    onlyMigratable?: boolean;
+}
+export declare function executeMigrationPlan(plan: MigrationPlan, options: ExecuteOptions): Promise<MigrationReport>;
+declare const MIGRATION_STAMP_FILENAME = "legacy-migrator.json";
+export declare function writeMigrationStamp(report: MigrationReport): void;
+export declare function readMigrationStamp(): {
+    finishedAt: string;
+    summary: MigrationReport["summary"];
+} | null;
+export { MIGRATION_ID, MIGRATION_STAMP_FILENAME, SCHEMA_VERSION };
+export declare function ensureAppsRoot(): void;
+export declare function makeFreshDir(instanceId: string): string;