@llblab/pi-actors 0.29.1 → 0.29.2

package/AGENTS.md

@@ -45,7 +45,7 @@ Treat this extension as an experimental self-evolution membrane for the agent ha
 
 ## Operating Principles
 
-- Prefer explicit migration boundaries over silent user-config rewrites.
+- Prefer explicit operator action over silent user-config rewrites.
 - Keep published documentation portable: use `~`, `<repo>`, or relative paths instead of machine-local absolute paths.
 - Preserve runtime output discipline because tool output flows directly into agent context.
 - Keep the project lens local-first and cybernetic: agents wrap durable local capabilities as actors, then use semantic tools and messages instead of repeatedly reconstructing shell commands.
@@ -82,7 +82,7 @@ Treat this extension as an experimental self-evolution membrane for the agent ha
 ## Recipes And Registry
 
 - `~/.pi/agent/recipes/*.json` is executable muscle memory: recipes there become persistent tools by location.
-- Preserve filename identity, atomic writes, explicit operator-gated migration paths, and local transportability.
+- Preserve filename identity, atomic writes, explicit operator-gated changes, and local transportability.
 - Packaged/ad hoc recipes outside the agent root are components, not user tools.
 - Tool definitions use `template`, not `script`, and built-in/core tool names must not be shadowed.
 - Packaged recipe growth is demand-driven: prefer reusable components over speculative scenario catalogs.

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.29.2: Legacy Migration Removal Hotfix
+
+- `[Registry]` Removed the old legacy tool-registry migration path now that recipe-file storage is the only maintained persistence surface.
+
 ## 0.29.1: Subagent TTL Kill Hotfix
 
 - `[Coordinator]` Added `subagent_ttl_ms` / `--subagent-ttl-ms` to the room-swarm adapter so timed-out subagent `pi -p` processes are terminated instead of only awaited.

package/dist/lib/config.d.ts

@@ -1,6 +1,6 @@
 /**
  * Persistent tool registry config helpers
- * Zones: registry config, persistence, migration boundary
+ * Zones: registry config, persistence, normalization
  * Owns registered-tool config loading, normalization, unsupported-shape rejection, and serialization
  */
 import type { CommandTemplateValue } from "./command-templates.ts";

package/dist/lib/config.js

@@ -1,6 +1,6 @@
 /**
  * Persistent tool registry config helpers
- * Zones: registry config, persistence, migration boundary
+ * Zones: registry config, persistence, normalization
  * Owns registered-tool config loading, normalization, unsupported-shape rejection, and serialization
  */
 import { existsSync, readFileSync } from "node:fs";

package/dist/lib/recipe-discovery.d.ts

@@ -1,6 +1,6 @@
 /**
  * File-discovered recipe registry helpers
- * Zones: recipe discovery, tool exposure, migration diagnostics
+ * Zones: recipe discovery, tool exposure, registry diagnostics
  * Owns filename identity discovery across prioritized recipe roots
  */
 import type { RegisteredTool } from "./config.ts";

package/dist/lib/recipe-discovery.js

@@ -1,6 +1,6 @@
 /**
  * File-discovered recipe registry helpers
- * Zones: recipe discovery, tool exposure, migration diagnostics
+ * Zones: recipe discovery, tool exposure, registry diagnostics
  * Owns filename identity discovery across prioritized recipe roots
  */
 import { createHash } from "node:crypto";
@@ -38,8 +38,7 @@ function listRecipeFiles(root) {
         return [];
     return readdirSync(root, { withFileTypes: true })
         .filter((entry) => entry.isFile() &&
-        (entry.name.endsWith(".json") || entry.name.endsWith(".md")) &&
-        entry.name !== "legacy-tool-registry-migration-report.json")
+        (entry.name.endsWith(".json") || entry.name.endsWith(".md")))
         .map((entry) => join(root, entry.name))
         .sort((a, b) => a
         .replace(/\.md$/, ".json")

package/dist/lib/runtime.js

@@ -5,7 +5,6 @@
  */
 import * as Paths from "./paths.js";
 import * as RecipeDiscovery from "./recipe-discovery.js";
-import * as RecipeMigration from "./recipe-migration.js";
 import * as Tools from "./tools.js";
 export function createAutoToolsRuntime(deps) {
     const tools = new Map();
@@ -86,16 +85,6 @@ export function createAutoToolsRuntime(deps) {
         const warnings = [];
         const recipeRoot = deps.recipeRoot ?? Paths.getRecipeRoot();
         const packagedRecipeRoot = deps.packagedRecipeRoot ?? Paths.getPackagedRecipeRoot();
-        const migration = RecipeMigration.migrateLegacyToolRegistry({
-            configPath: deps.configPath,
-            recipeRoot,
-            reservedToolNames: deps.reservedToolNames,
-        });
-        warnings.push(...migration.warnings);
-        if (migration.conflicts.length > 0)
-            warnings.push(`Recipe migration conflicts: ${migration.conflicts.join(", ")}`);
-        if (migration.invalid.length > 0)
-            warnings.push(`Recipe migration invalid entries: ${migration.invalid.join(", ")}`);
         const discovered = RecipeDiscovery.discoverRecipeSources([
             { root: recipeRoot, defaultTool: true, mutableUsage: true },
             { root: packagedRecipeRoot },

package/dist/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.29.1
+  version: 0.29.2
 ---
 
 # Actors (pi-actors)

package/dist/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.29.1
+  version: 0.29.2
 ---
 
 # Swarm

package/lib/config.ts

@@ -1,6 +1,6 @@
 /**
  * Persistent tool registry config helpers
- * Zones: registry config, persistence, migration boundary
+ * Zones: registry config, persistence, normalization
  * Owns registered-tool config loading, normalization, unsupported-shape rejection, and serialization
  */
 

package/lib/recipe-discovery.ts

@@ -1,6 +1,6 @@
 /**
  * File-discovered recipe registry helpers
- * Zones: recipe discovery, tool exposure, migration diagnostics
+ * Zones: recipe discovery, tool exposure, registry diagnostics
  * Owns filename identity discovery across prioritized recipe roots
  */
 
@@ -98,8 +98,7 @@ function listRecipeFiles(root: string): string[] {
     .filter(
       (entry) =>
         entry.isFile() &&
-        (entry.name.endsWith(".json") || entry.name.endsWith(".md")) &&
-        entry.name !== "legacy-tool-registry-migration-report.json",
+        (entry.name.endsWith(".json") || entry.name.endsWith(".md")),
     )
     .map((entry) => join(root, entry.name))
     .sort(

package/lib/runtime.ts

@@ -8,7 +8,6 @@ import * as Config from "./config.ts";
 import type { RegisteredToolExec } from "./execution.ts";
 import * as Paths from "./paths.ts";
 import * as RecipeDiscovery from "./recipe-discovery.ts";
-import * as RecipeMigration from "./recipe-migration.ts";
 import * as Tools from "./tools.ts";
 
 export interface RuntimeContext {
@@ -142,20 +141,6 @@ export function createAutoToolsRuntime(
     const recipeRoot = deps.recipeRoot ?? Paths.getRecipeRoot();
     const packagedRecipeRoot =
       deps.packagedRecipeRoot ?? Paths.getPackagedRecipeRoot();
-    const migration = RecipeMigration.migrateLegacyToolRegistry({
-      configPath: deps.configPath,
-      recipeRoot,
-      reservedToolNames: deps.reservedToolNames,
-    });
-    warnings.push(...migration.warnings);
-    if (migration.conflicts.length > 0)
-      warnings.push(
-        `Recipe migration conflicts: ${migration.conflicts.join(", ")}`,
-      );
-    if (migration.invalid.length > 0)
-      warnings.push(
-        `Recipe migration invalid entries: ${migration.invalid.join(", ")}`,
-      );
     const discovered = RecipeDiscovery.discoverRecipeSources([
       { root: recipeRoot, defaultTool: true, mutableUsage: true },
       { root: packagedRecipeRoot },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@llblab/pi-actors",
-  "version": "0.29.1",
+  "version": "0.29.2",
   "private": false,
   "description": "Local Actor Kernel for Pi",
   "keywords": [

package/skills/actors/SKILL.md

@@ -2,7 +2,7 @@
 name: actors
 description: Highest-density practical guide for pi-actors. Read this skill whenever prompt and tools are not enough for spawn, message, inspect, actor runs, tools, recipes, command templates, async lifecycle, mailboxes, artifacts, and local orchestration mechanics.
 metadata:
-  version: 0.29.1
+  version: 0.29.2
 ---
 
 # Actors (pi-actors)

package/skills/swarm/SKILL.md

@@ -2,7 +2,7 @@
 name: swarm
 description: Subagent orchestration with scoped locks and quorum consensus. Use for multi-model review, parallel scoped work, delegated audit, and coordinated subagent execution.
 metadata:
-  version: 0.29.1
+  version: 0.29.2
 ---
 
 # Swarm

package/dist/lib/recipe-migration.d.ts

@@ -1,21 +0,0 @@
-/**
- * Legacy tool-registry to recipe-file migration helpers
- * Zones: registry migration, recipe persistence, compatibility diagnostics
- * Owns one-way migration from legacy tool registry entries into user recipe files
- */
-export interface LegacyRegistryMigrationResult {
-    migrated: string[];
-    skipped: string[];
-    conflicts: string[];
-    invalid: string[];
-    archive?: string;
-    report?: string;
-    warnings: string[];
-}
-export interface LegacyRegistryMigrationOptions {
-    configPath: string;
-    recipeRoot: string;
-    reservedToolNames: Set<string>;
-    archive?: boolean;
-}
-export declare function migrateLegacyToolRegistry(options: LegacyRegistryMigrationOptions): LegacyRegistryMigrationResult;

package/dist/lib/recipe-migration.js

@@ -1,90 +0,0 @@
-/**
- * Legacy tool-registry to recipe-file migration helpers
- * Zones: registry migration, recipe persistence, compatibility diagnostics
- * Owns one-way migration from legacy tool registry entries into user recipe files
- */
-import { existsSync, mkdirSync, renameSync } from "node:fs";
-import { basename, join } from "node:path";
-import * as Config from "./config.js";
-import { writeJsonAtomic } from "./file-state.js";
-import * as RecipeReferences from "./recipe-references.js";
-function recipePathForTool(recipeRoot, name) {
-    return join(recipeRoot, `${name}.json`);
-}
-function toRecipeConfig(tool) {
-    return {
-        description: tool.description,
-        ...(tool.recipe?.async !== undefined ? { async: tool.recipe.async } : {}),
-        ...(tool.recipe?.state_dir ? { state_dir: tool.recipe.state_dir } : {}),
-        ...(tool.storedArgs ? { args: tool.storedArgs } : {}),
-        ...(tool.storedDefaults ? { defaults: tool.storedDefaults } : {}),
-        template: tool.template,
-        ...(tool.recipe?.values ? { values: tool.recipe.values } : {}),
-    };
-}
-function nextArchivePath(configPath) {
-    const base = `${configPath}.migrated`;
-    if (!existsSync(base))
-        return base;
-    for (let index = 1; index < 1000; index += 1) {
-        const path = `${base}.${index}`;
-        if (!existsSync(path))
-            return path;
-    }
-    return `${base}.${Date.now()}`;
-}
-export function migrateLegacyToolRegistry(options) {
-    const { configPath, recipeRoot, reservedToolNames } = options;
-    const result = {
-        migrated: [],
-        skipped: [],
-        conflicts: [],
-        invalid: [],
-        warnings: [],
-    };
-    if (!existsSync(configPath))
-        return result;
-    const loaded = Config.loadToolConfig(configPath, reservedToolNames);
-    result.warnings.push(...loaded.warnings);
-    mkdirSync(recipeRoot, { recursive: true });
-    for (const [name, tool] of loaded.tools) {
-        const path = recipePathForTool(recipeRoot, name);
-        if (existsSync(path)) {
-            result.conflicts.push(name);
-            continue;
-        }
-        const recipe = toRecipeConfig(tool);
-        try {
-            writeJsonAtomic(path, recipe);
-            const parsed = RecipeReferences.readResolvedRecipeConfig(path);
-            if (!parsed) {
-                result.invalid.push(name);
-                continue;
-            }
-            result.migrated.push(name);
-        }
-        catch (error) {
-            result.invalid.push(`${name}: ${error instanceof Error ? error.message : String(error)}`);
-        }
-    }
-    if (loaded.tools.size === 0)
-        result.skipped.push(basename(configPath));
-    const reportPath = join(recipeRoot, "legacy-tool-registry-migration-report.json");
-    writeJsonAtomic(reportPath, {
-        source: configPath,
-        migrated: result.migrated,
-        skipped: result.skipped,
-        conflicts: result.conflicts,
-        invalid: result.invalid,
-        warnings: result.warnings,
-    });
-    result.report = reportPath;
-    if (options.archive !== false &&
-        result.conflicts.length === 0 &&
-        result.invalid.length === 0) {
-        const archive = nextArchivePath(configPath);
-        renameSync(configPath, archive);
-        result.archive = archive;
-    }
-    return result;
-}

package/lib/recipe-migration.ts

@@ -1,121 +0,0 @@
-/**
- * Legacy tool-registry to recipe-file migration helpers
- * Zones: registry migration, recipe persistence, compatibility diagnostics
- * Owns one-way migration from legacy tool registry entries into user recipe files
- */
-
-import { existsSync, mkdirSync, renameSync } from "node:fs";
-import { basename, join } from "node:path";
-
-import * as Config from "./config.ts";
-import { writeJsonAtomic } from "./file-state.ts";
-import type { TemplateRecipeConfig } from "./recipe-references.ts";
-import * as RecipeReferences from "./recipe-references.ts";
-
-export interface LegacyRegistryMigrationResult {
-  migrated: string[];
-  skipped: string[];
-  conflicts: string[];
-  invalid: string[];
-  archive?: string;
-  report?: string;
-  warnings: string[];
-}
-
-export interface LegacyRegistryMigrationOptions {
-  configPath: string;
-  recipeRoot: string;
-  reservedToolNames: Set<string>;
-  archive?: boolean;
-}
-
-function recipePathForTool(recipeRoot: string, name: string): string {
-  return join(recipeRoot, `${name}.json`);
-}
-
-function toRecipeConfig(tool: Config.RegisteredTool): TemplateRecipeConfig {
-  return {
-    description: tool.description,
-    ...(tool.recipe?.async !== undefined ? { async: tool.recipe.async } : {}),
-    ...(tool.recipe?.state_dir ? { state_dir: tool.recipe.state_dir } : {}),
-    ...(tool.storedArgs ? { args: tool.storedArgs } : {}),
-    ...(tool.storedDefaults ? { defaults: tool.storedDefaults } : {}),
-    template: tool.template!,
-    ...(tool.recipe?.values ? { values: tool.recipe.values } : {}),
-  };
-}
-
-function nextArchivePath(configPath: string): string {
-  const base = `${configPath}.migrated`;
-  if (!existsSync(base)) return base;
-  for (let index = 1; index < 1000; index += 1) {
-    const path = `${base}.${index}`;
-    if (!existsSync(path)) return path;
-  }
-  return `${base}.${Date.now()}`;
-}
-
-export function migrateLegacyToolRegistry(
-  options: LegacyRegistryMigrationOptions,
-): LegacyRegistryMigrationResult {
-  const { configPath, recipeRoot, reservedToolNames } = options;
-  const result: LegacyRegistryMigrationResult = {
-    migrated: [],
-    skipped: [],
-    conflicts: [],
-    invalid: [],
-    warnings: [],
-  };
-  if (!existsSync(configPath)) return result;
-
-  const loaded = Config.loadToolConfig(configPath, reservedToolNames);
-  result.warnings.push(...loaded.warnings);
-  mkdirSync(recipeRoot, { recursive: true });
-
-  for (const [name, tool] of loaded.tools) {
-    const path = recipePathForTool(recipeRoot, name);
-    if (existsSync(path)) {
-      result.conflicts.push(name);
-      continue;
-    }
-    const recipe = toRecipeConfig(tool);
-    try {
-      writeJsonAtomic(path, recipe);
-      const parsed = RecipeReferences.readResolvedRecipeConfig(path);
-      if (!parsed) {
-        result.invalid.push(name);
-        continue;
-      }
-      result.migrated.push(name);
-    } catch (error) {
-      result.invalid.push(
-        `${name}: ${error instanceof Error ? error.message : String(error)}`,
-      );
-    }
-  }
-
-  if (loaded.tools.size === 0) result.skipped.push(basename(configPath));
-
-  const reportPath = join(recipeRoot, "legacy-tool-registry-migration-report.json");
-  writeJsonAtomic(reportPath, {
-    source: configPath,
-    migrated: result.migrated,
-    skipped: result.skipped,
-    conflicts: result.conflicts,
-    invalid: result.invalid,
-    warnings: result.warnings,
-  });
-  result.report = reportPath;
-
-  if (
-    options.archive !== false &&
-    result.conflicts.length === 0 &&
-    result.invalid.length === 0
-  ) {
-    const archive = nextArchivePath(configPath);
-    renameSync(configPath, archive);
-    result.archive = archive;
-  }
-
-  return result;
-}