npm - @iceinvein/agent-skills - Versions diffs - 0.1.39 → 0.2.0 - Mend

@iceinvein/agent-skills 0.1.39 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (148) hide show

package/README.md +18 -2
package/dist/cli/index.js +105 -28
package/package.json +1 -1
package/skills/index.json +14 -2
package/skills/magpie/README.md +2 -1
package/skills/magpie/SKILL.md +138 -45
package/skills/magpie/bin/magpie.ts +43 -0
package/skills/magpie/fixtures/example-pr/brief.json +18 -0
package/skills/magpie/fixtures/fake-gh-nodiff.sh +38 -0
package/skills/magpie/fixtures/fake-gh.sh +14 -0
package/skills/magpie/package.json +1 -1
package/skills/magpie/references/peer-review.md +7 -2
package/skills/magpie/references/scout.md +90 -0
package/skills/magpie/references/specialists.md +117 -6
package/skills/magpie/scripts/__tests__/cli.test.ts +101 -1
package/skills/magpie/scripts/__tests__/dedupe-cmd.test.ts +187 -0
package/skills/magpie/scripts/__tests__/diff-chunks.test.ts +51 -0
package/skills/magpie/scripts/__tests__/filter-diff-preservation.test.ts +54 -0
package/skills/magpie/scripts/__tests__/findings-files.test.ts +35 -0
package/skills/magpie/scripts/__tests__/gh.test.ts +90 -0
package/skills/magpie/scripts/__tests__/git-diff.test.ts +83 -0
package/skills/magpie/scripts/__tests__/helpers/git-fixture.ts +47 -0
package/skills/magpie/scripts/__tests__/path-filter.test.ts +27 -0
package/skills/magpie/scripts/__tests__/preview-cmd.test.ts +16 -0
package/skills/magpie/scripts/__tests__/refresh.test.ts +45 -0
package/skills/magpie/scripts/__tests__/render-cmd.test.ts +173 -1
package/skills/magpie/scripts/__tests__/render-findings.test.ts +151 -1
package/skills/magpie/scripts/__tests__/render-progress.test.ts +42 -0
package/skills/magpie/scripts/__tests__/setup-cmd.test.ts +83 -1
package/skills/magpie/scripts/__tests__/shard.test.ts +165 -0
package/skills/magpie/scripts/__tests__/skill-lint.test.ts +207 -7
package/skills/magpie/scripts/__tests__/types.test.ts +47 -0
package/skills/magpie/scripts/dedupe-cmd.ts +58 -3
package/skills/magpie/scripts/diff-chunks.ts +28 -0
package/skills/magpie/scripts/findings-files.ts +32 -0
package/skills/magpie/scripts/gh.ts +68 -14
package/skills/magpie/scripts/git-diff.ts +111 -0
package/skills/magpie/scripts/path-filter.ts +9 -5
package/skills/magpie/scripts/preview-cmd.ts +11 -1
package/skills/magpie/scripts/refresh.ts +32 -3
package/skills/magpie/scripts/render-cmd.ts +35 -11
package/skills/magpie/scripts/render-findings.ts +78 -2
package/skills/magpie/scripts/render-progress.ts +6 -1
package/skills/magpie/scripts/setup-cmd.ts +38 -1
package/skills/magpie/scripts/shard.ts +171 -0
package/skills/magpie/scripts/status-cmd.ts +7 -4
package/skills/magpie/scripts/types.ts +50 -0
package/skills/magpie/skill.json +2 -2
package/skills/magpie/templates/styles.css +66 -0
package/skills/migrate/README.md +194 -0
package/skills/migrate/SKILL.md +197 -0
package/skills/migrate/bin/migrate +15 -0
package/skills/migrate/bin/migrate.ts +309 -0
package/skills/migrate/biome.json +35 -0
package/skills/migrate/bun.lock +24 -0
package/skills/migrate/docs/architecture.md +294 -0
package/skills/migrate/docs/reference.md +590 -0
package/skills/migrate/fixtures/tiny-express/GROUND-TRUTH.md +39 -0
package/skills/migrate/fixtures/tiny-express/app.js +29 -0
package/skills/migrate/fixtures/tiny-express/cron.js +6 -0
package/skills/migrate/fixtures/tiny-express/reports/daily-users.json +6 -0
package/skills/migrate/fixtures/tiny-express/schema.sql +12 -0
package/skills/migrate/fixtures/tiny-express/settings.json +4 -0
package/skills/migrate/fixtures/tiny-express/views/users.html +9 -0
package/skills/migrate/fixtures/tiny-webforms/Controllers/UsersController.cs +68 -0
package/skills/migrate/fixtures/tiny-webforms/Default.aspx +7 -0
package/skills/migrate/fixtures/tiny-webforms/Default.aspx.cs +14 -0
package/skills/migrate/fixtures/tiny-webforms/GROUND-TRUTH.md +50 -0
package/skills/migrate/fixtures/tiny-webforms/Integrations/BillingClient.cs +16 -0
package/skills/migrate/fixtures/tiny-webforms/Jobs/NightlyDigestJob.cs +33 -0
package/skills/migrate/fixtures/tiny-webforms/Reports/DailyUsers.rdl +11 -0
package/skills/migrate/fixtures/tiny-webforms/Schema.sql +12 -0
package/skills/migrate/fixtures/tiny-webforms/Site.master +16 -0
package/skills/migrate/fixtures/tiny-webforms/Users.aspx +8 -0
package/skills/migrate/fixtures/tiny-webforms/Users.aspx.cs +14 -0
package/skills/migrate/fixtures/tiny-webforms/web.config +10 -0
package/skills/migrate/install.sh +68 -0
package/skills/migrate/package.json +17 -0
package/skills/migrate/references/phases/enumerate.md +291 -0
package/skills/migrate/references/phases/extract.md +652 -0
package/skills/migrate/references/phases/parity.md +275 -0
package/skills/migrate/references/phases/probe.md +135 -0
package/skills/migrate/references/phases/queue.md +242 -0
package/skills/migrate/references/phases/seam.md +416 -0
package/skills/migrate/references/recipes/README.md +116 -0
package/skills/migrate/references/recipes/aspnet.md +287 -0
package/skills/migrate/references/run-ops.md +280 -0
package/skills/migrate/scripts/__tests__/census.test.ts +775 -0
package/skills/migrate/scripts/__tests__/check.test.ts +458 -0
package/skills/migrate/scripts/__tests__/citations.test.ts +156 -0
package/skills/migrate/scripts/__tests__/cli.test.ts +183 -0
package/skills/migrate/scripts/__tests__/concurrency.test.ts +164 -0
package/skills/migrate/scripts/__tests__/config.test.ts +112 -0
package/skills/migrate/scripts/__tests__/e2e-express.test.ts +1093 -0
package/skills/migrate/scripts/__tests__/e2e-webforms.test.ts +1276 -0
package/skills/migrate/scripts/__tests__/e2e.test.ts +320 -0
package/skills/migrate/scripts/__tests__/ids.test.ts +38 -0
package/skills/migrate/scripts/__tests__/import.test.ts +155 -0
package/skills/migrate/scripts/__tests__/init.test.ts +192 -0
package/skills/migrate/scripts/__tests__/leaks.test.ts +176 -0
package/skills/migrate/scripts/__tests__/lock.test.ts +183 -0
package/skills/migrate/scripts/__tests__/paths.test.ts +129 -0
package/skills/migrate/scripts/__tests__/phase-cmd.test.ts +151 -0
package/skills/migrate/scripts/__tests__/phases.test.ts +70 -0
package/skills/migrate/scripts/__tests__/queue.test.ts +475 -0
package/skills/migrate/scripts/__tests__/report.test.ts +150 -0
package/skills/migrate/scripts/__tests__/run-state.test.ts +136 -0
package/skills/migrate/scripts/__tests__/status-reset.test.ts +318 -0
package/skills/migrate/scripts/__tests__/store.test.ts +132 -0
package/skills/migrate/scripts/__tests__/validate.test.ts +54 -0
package/skills/migrate/scripts/census-cmd.ts +109 -0
package/skills/migrate/scripts/census.ts +342 -0
package/skills/migrate/scripts/check-cmd.ts +24 -0
package/skills/migrate/scripts/check.ts +376 -0
package/skills/migrate/scripts/citations.ts +92 -0
package/skills/migrate/scripts/config.ts +237 -0
package/skills/migrate/scripts/ids.ts +31 -0
package/skills/migrate/scripts/import-cmd.ts +141 -0
package/skills/migrate/scripts/init-cmd.ts +118 -0
package/skills/migrate/scripts/leaks.ts +184 -0
package/skills/migrate/scripts/lock.ts +188 -0
package/skills/migrate/scripts/paths.ts +103 -0
package/skills/migrate/scripts/phase-cmd.ts +63 -0
package/skills/migrate/scripts/phases.ts +113 -0
package/skills/migrate/scripts/queue-cmd.ts +98 -0
package/skills/migrate/scripts/queue.ts +258 -0
package/skills/migrate/scripts/report-cmd.ts +47 -0
package/skills/migrate/scripts/report.ts +131 -0
package/skills/migrate/scripts/reset-cmd.ts +120 -0
package/skills/migrate/scripts/status-cmd.ts +52 -0
package/skills/migrate/scripts/store.ts +159 -0
package/skills/migrate/scripts/types.ts +137 -0
package/skills/migrate/scripts/validate.ts +221 -0
package/skills/migrate/skill.json +33 -0
package/skills/migrate/templates/config.toml +27 -0
package/skills/migrate/templates/queue-item.md +17 -0
package/skills/migrate/tsconfig.json +18 -0
package/skills/migrate/uninstall.sh +31 -0
package/skills/sluice/SKILL.md +82 -0
package/skills/sluice/references/deep-channel.md +94 -0
package/skills/sluice/references/finish.md +35 -0
package/skills/sluice/references/intent.md +29 -0
package/skills/sluice/references/review.md +42 -0
package/skills/sluice/references/root-cause.md +38 -0
package/skills/sluice/references/show-or-say.md +36 -0
package/skills/sluice/references/test-first.md +35 -0
package/skills/sluice/references/verify.md +26 -0
package/skills/sluice/skill.json +32 -0

package/skills/migrate/fixtures/tiny-express/schema.sql ADDED Viewed

@@ -0,0 +1,12 @@
+CREATE TABLE users (
+  id INTEGER PRIMARY KEY,
+  email TEXT NOT NULL,
+  is_active INTEGER NOT NULL DEFAULT 1
+);
+CREATE TABLE audit_log (
+  id INTEGER PRIMARY KEY,
+  user_id INTEGER NOT NULL,
+  action TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);

package/skills/migrate/fixtures/tiny-express/settings.json ADDED Viewed

@@ -0,0 +1,4 @@
+{
+  "welcomeEmailEnabled": true,
+  "maxUsersPerPage": 50
+}

package/skills/migrate/fixtures/tiny-express/views/users.html ADDED Viewed

@@ -0,0 +1,9 @@
+<!doctype html>
+<html>
+  <body>
+    <h1>Users</h1>
+    <ul>
+      <li data-bind="email"></li>
+    </ul>
+  </body>
+</html>

package/skills/migrate/fixtures/tiny-webforms/Controllers/UsersController.cs ADDED Viewed

@@ -0,0 +1,68 @@
+using System;
+using System.Configuration;
+using System.Data.SqlClient;
+using System.Web;
+using System.Web.Http;
+using TinyWebForms.Integrations;
+namespace TinyWebForms.Controllers
+{
+  [RoutePrefix("api/users")]
+  public class UsersController : ApiController
+  {
+    private readonly BillingClient _billing = new BillingClient();
+    private SqlConnection OpenConnection()
+    {
+      var connStr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;
+      var conn = new SqlConnection(connStr);
+      conn.Open();
+      return conn;
+    }
+    [HttpGet]
+    [Route("")]
+    public IHttpActionResult GetUsers()
+    {
+      using (var conn = OpenConnection())
+      {
+        var cmd = new SqlCommand("SELECT Id, Email FROM [dbo].[Users] WHERE IsActive = 1", conn);
+        return Ok(cmd.ExecuteReader());
+      }
+    }
+    /*
+     * Historical note: an earlier draft issued a raw UPDATE LegacyUsers SET
+     * migrated = 1 statement here before the API layer replaced it.
+     */
+    [HttpPost]
+    [Route("")]
+    public IHttpActionResult CreateUser(UserSignupRequest request)
+    {
+      using (var conn = OpenConnection())
+      {
+        var cmd = new SqlCommand("INSERT INTO Users (Email, IsActive) VALUES (@email, 1)", conn);
+        cmd.Parameters.AddWithValue("@email", request.Email);
+        cmd.ExecuteNonQuery();
+      }
+      var id = DateTime.UtcNow.Ticks;
+      HttpContext.Current.Session["PendingWelcome_" + id] = request.Email;
+      return Ok(new { id });
+    }
+    [HttpGet]
+    [Route("{id}/welcome")]
+    public IHttpActionResult GetWelcomeStatus(long id)
+    {
+      var email = HttpContext.Current.Session["PendingWelcome_" + id] as string;
+      var enabled = ConfigurationManager.AppSettings["WelcomeEmailEnabled"];
+      if (enabled == "true" && email != null) _billing.NotifyActivation(id);
+      return Ok(new { sent = email != null });
+    }
+  }
+  public class UserSignupRequest
+  {
+    public string Email { get; set; }
+  }
+}

package/skills/migrate/fixtures/tiny-webforms/Default.aspx ADDED Viewed

@@ -0,0 +1,7 @@
+<%@ Page Language="C#" AutoEventWireup="true" MasterPageFile="~/Site.master" CodeFile="Default.aspx.cs" Inherits="TinyWebForms.DefaultPage" %>
+<!-- Workflow step 1: signup screen, posts toward POST api/users, hands off to Users.aspx. -->
+<asp:Content ContentPlaceHolderID="MainContent" runat="server">
+  <h1>Sign up</h1>
+  <asp:TextBox ID="EmailBox" runat="server" />
+  <asp:Button ID="SignupButton" runat="server" Text="Sign up" OnClick="SignupButton_Click" />
+</asp:Content>

package/skills/migrate/fixtures/tiny-webforms/Default.aspx.cs ADDED Viewed

@@ -0,0 +1,14 @@
+using System;
+using TinyWebForms.Controllers;
+namespace TinyWebForms
+{
+  public partial class DefaultPage : System.Web.UI.Page
+  {
+    protected void SignupButton_Click(object sender, EventArgs e)
+    {
+      new UsersController().CreateUser(new UserSignupRequest { Email = EmailBox.Text });
+      Response.Redirect("~/Users.aspx");
+    }
+  }
+}

package/skills/migrate/fixtures/tiny-webforms/GROUND-TRUTH.md ADDED Viewed

@@ -0,0 +1,50 @@
+# Ground truth for tiny-webforms
+Sixteen elements across all eight default surfaces. Any enumeration run over
+this fixture must find exactly these, and the census must balance at these
+totals: 5 routes, 2 tables, 1 job, 1 report, 2 screens, 1 integration, 1
+workflow, 3 settings.
+| surface | id | element |
+| --- | --- | --- |
+| routes | route-get-api-users | GET api/users |
+| routes | route-post-api-users | POST api/users |
+| routes | route-get-api-users-id-welcome | GET api/users/{id}/welcome |
+| routes | route-default-aspx | Default.aspx |
+| routes | route-users-aspx | Users.aspx |
+| tables | table-users | Users |
+| tables | table-audit-log | AuditLog |
+| jobs | job-nightly-digest | nightly purge of AuditLog rows older than the configured cutoff |
+| reports | report-daily-users | daily active users report |
+| screens | screen-default | signup screen (Default.aspx) |
+| screens | screen-users | users list and welcome screen (Users.aspx) |
+| integrations | integration-billing-sync | outbound call to the billing system on activation |
+| workflows | workflow-signup-welcome | two-page signup then welcome workflow |
+| settings | setting-welcome-email-enabled | WelcomeEmailEnabled |
+| settings | setting-nightly-digest-cutoff-days | NightlyDigestCutoffDays |
+| settings | setting-default-connection | DefaultConnection |
+## Element-to-element touches
+Eight of these elements touch another element already in this table, the
+kind of touch `references/phases/enumerate.md`'s Procedure (step 4) tells a
+lens to record as a `{"kind": "ledger", "id": ...}` ref, and the only edge
+data `references/phases/seam.md`'s surface-affinity clustering has to
+build a graph from. Kept here as prose, not as a fourth table column,
+because unlike the census columns above nothing parses this: the e2e test
+records these refs by hand against the ids above, the same way a real
+lens would, rather than by reading this section.
+- `route-get-api-users` reads `table-users`.
+- `route-post-api-users` writes `table-users`.
+- `route-get-api-users-id-welcome` notifies `integration-billing-sync`.
+- `job-nightly-digest` purges `table-audit-log`.
+- `report-daily-users` queries `table-users`.
+- `workflow-signup-welcome` spans `route-post-api-users`,
+  `route-get-api-users-id-welcome`, and `setting-welcome-email-enabled`.
+- `screen-default` posts to `route-post-api-users`: `Default.aspx.cs`'s
+  signup button handler calls `UsersController.CreateUser` directly, the
+  screen-that-posts-to-a-route example `enumerate.md`'s step 4 names as its
+  own canonical case.
+- `screen-users` checks `route-get-api-users-id-welcome`: `Users.aspx.cs`'s
+  `Page_Load` calls `UsersController.GetWelcomeStatus` directly.

package/skills/migrate/fixtures/tiny-webforms/Integrations/BillingClient.cs ADDED Viewed

@@ -0,0 +1,16 @@
+using System.Net.Http;
+namespace TinyWebForms.Integrations
+{
+  // Notifies the external billing system once a signed-up user is activated.
+  public class BillingClient
+  {
+    private readonly HttpClient _client = new HttpClient();
+    public void NotifyActivation(long userId)
+    {
+      var body = new StringContent("{\"userId\":" + userId + "}");
+      _client.PostAsync("https://billing.example.com/activations", body).Wait();
+    }
+  }
+}

package/skills/migrate/fixtures/tiny-webforms/Jobs/NightlyDigestJob.cs ADDED Viewed

@@ -0,0 +1,33 @@
+using System;
+using System.Configuration;
+using System.Data.SqlClient;
+using Quartz;
+namespace TinyWebForms.Jobs
+{
+  // Nightly purge of AuditLog rows older than the configured cutoff.
+  public class NightlyDigestJob : IJob
+  {
+    public void Execute(IJobExecutionContext context)
+    {
+      var cutoffDays = int.Parse(ConfigurationManager.AppSettings["NightlyDigestCutoffDays"]);
+      var connStr = ConfigurationManager.ConnectionStrings["DefaultConnection"].ConnectionString;
+      using (var conn = new SqlConnection(connStr))
+      {
+        var cmd = new SqlCommand("DELETE FROM dbo.AuditLog WHERE CreatedAt < @cutoff", conn);
+        cmd.Parameters.AddWithValue("@cutoff", DateTime.UtcNow.AddDays(-cutoffDays));
+        conn.Open();
+        cmd.ExecuteNonQuery();
+      }
+    }
+  }
+  public static class NightlyDigestJobScheduler
+  {
+    public static void Register(IScheduler scheduler)
+    {
+      var job = JobBuilder.Create<NightlyDigestJob>().WithIdentity("nightly-digest").Build();
+      scheduler.ScheduleJob(job, TriggerBuilder.Create().WithCronSchedule("0 0 2 * * ?").Build());
+    }
+  }
+}

package/skills/migrate/fixtures/tiny-webforms/Reports/DailyUsers.rdl ADDED Viewed

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Report xmlns="http://schemas.microsoft.com/sqlserver/reporting/2016/01/reportdefinition">
+  <DataSets>
+    <DataSet Name="DailyUsers">
+      <Query>
+        <CommandText>SELECT COUNT(*) AS ActiveUsers FROM Users WHERE IsActive = 1</CommandText>
+      </Query>
+    </DataSet>
+  </DataSets>
+  <Description>Daily count of active users</Description>
+</Report>

package/skills/migrate/fixtures/tiny-webforms/Schema.sql ADDED Viewed

@@ -0,0 +1,12 @@
+CREATE TABLE Users (
+  Id INT PRIMARY KEY,
+  Email NVARCHAR(200) NOT NULL,
+  IsActive BIT NOT NULL DEFAULT 1
+);
+CREATE TABLE AuditLog (
+  Id INT PRIMARY KEY,
+  UserId INT NOT NULL,
+  Action NVARCHAR(100) NOT NULL,
+  CreatedAt DATETIME NOT NULL
+);

package/skills/migrate/fixtures/tiny-webforms/Site.master ADDED Viewed

@@ -0,0 +1,16 @@
+<%@ Master Language="C#" %>
+<!-- Nav lives here, not in a sitemap or _Layout.cshtml: the WebForms half of this mixed app. -->
+<!DOCTYPE html>
+<html>
+<head><title>Tiny WebForms</title></head>
+<body>
+  <form runat="server">
+    <nav>
+      <asp:HyperLink runat="server" NavigateUrl="~/Default.aspx">Home</asp:HyperLink>
+      <asp:HyperLink runat="server" NavigateUrl="~/Users.aspx">Users</asp:HyperLink>
+      <a href="~/Reports/DailyUsers">Daily active users report</a>
+    </nav>
+    <asp:ContentPlaceHolder ID="MainContent" runat="server" />
+  </form>
+</body>
+</html>

package/skills/migrate/fixtures/tiny-webforms/Users.aspx ADDED Viewed

@@ -0,0 +1,8 @@
+<%@ Page Language="C#" AutoEventWireup="true" MasterPageFile="~/Site.master" CodeFile="Users.aspx.cs" Inherits="TinyWebForms.UsersPage" %>
+<!-- Workflow step 2: lands here after signup, checks api/users/{id}/welcome. -->
+<asp:Content ContentPlaceHolderID="MainContent" runat="server">
+  <h1>Users</h1>
+  <asp:Repeater ID="UsersList" runat="server">
+    <ItemTemplate><%# Eval("Email") %></ItemTemplate>
+  </asp:Repeater>
+</asp:Content>

package/skills/migrate/fixtures/tiny-webforms/Users.aspx.cs ADDED Viewed

@@ -0,0 +1,14 @@
+using System;
+using TinyWebForms.Controllers;
+namespace TinyWebForms
+{
+  public partial class UsersPage : System.Web.UI.Page
+  {
+    protected void Page_Load(object sender, EventArgs e)
+    {
+      var id = long.Parse(Request.QueryString["id"] ?? "0");
+      new UsersController().GetWelcomeStatus(id);
+    }
+  }
+}

package/skills/migrate/fixtures/tiny-webforms/web.config ADDED Viewed

@@ -0,0 +1,10 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <appSettings>
+    <add key="WelcomeEmailEnabled" value="true" />
+    <add key="NightlyDigestCutoffDays" value="30" />
+  </appSettings>
+  <connectionStrings>
+    <add name="DefaultConnection" connectionString="Data Source=.;Initial Catalog=TinyWebForms;Integrated Security=True" providerName="System.Data.SqlClient" />
+  </connectionStrings>
+</configuration>

package/skills/migrate/install.sh ADDED Viewed

@@ -0,0 +1,68 @@
+#!/usr/bin/env bash
+set -euo pipefail
+# This script is run by agent-skills as a postinstall step after the migrate
+# skill bundle has been written to disk. Its only job is to put the migrate
+# CLI on PATH and record where it linked, so uninstall.sh can clean up.
+SOURCE_DIR="$(cd "$(dirname "$0")" && pwd)"
+BIN_SOURCE="$SOURCE_DIR/bin/migrate"
+STATE_FILE="$SOURCE_DIR/.installed-cli-path"
+if [ ! -f "$BIN_SOURCE" ]; then
+  echo "migrate postinstall: bin/migrate missing at $BIN_SOURCE" >&2
+  exit 1
+fi
+chmod +x "$BIN_SOURCE" || true
+install_link() {
+  local dest_dir="$1"
+  local dest="$dest_dir/migrate"
+  if [ ! -d "$dest_dir" ]; then
+    mkdir -p "$dest_dir" 2>/dev/null || return 1
+  fi
+  if [ ! -w "$dest_dir" ]; then
+    return 1
+  fi
+  if [ -e "$dest" ] && [ ! -L "$dest" ]; then
+    echo "  skipping $dest_dir (a non-symlink migrate already exists there)"
+    return 2
+  fi
+  ln -snf "$BIN_SOURCE" "$dest"
+  echo "  linked  $dest -> $BIN_SOURCE"
+  printf '%s\n' "$dest" > "$STATE_FILE"
+  return 0
+}
+echo "Installing migrate CLI on PATH:"
+CLI_INSTALL_DIR=""
+if install_link "/usr/local/bin"; then
+  CLI_INSTALL_DIR="/usr/local/bin"
+elif install_link "$HOME/.local/bin"; then
+  CLI_INSTALL_DIR="$HOME/.local/bin"
+else
+  echo "  Could not write to /usr/local/bin or ~/.local/bin."
+  echo "  Add this alias to your shell rc instead:"
+  echo "    alias migrate='bun $BIN_SOURCE.ts'"
+fi
+if [ -n "$CLI_INSTALL_DIR" ]; then
+  case ":$PATH:" in
+    *":$CLI_INSTALL_DIR:"*) ;;
+    *)
+      echo ""
+      echo "  Note: $CLI_INSTALL_DIR is not on your PATH."
+      echo "  Add this to ~/.zshrc or ~/.bashrc:"
+      echo "    export PATH=\"$CLI_INSTALL_DIR:\$PATH\""
+      ;;
+  esac
+fi
+echo ""
+echo "Verify:"
+echo "  migrate --version"
+echo "  migrate --help"

package/skills/migrate/package.json ADDED Viewed

@@ -0,0 +1,17 @@
+{
+  "name": "migrate",
+  "version": "0.2.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "test": "bun test",
+    "lint": "biome check .",
+    "lint:fix": "biome check --write .",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/bun": "^1.2.0",
+    "typescript": "^5.9.0"
+  }
+}