@cosmicdrift/kumiko-framework 0.221.0 → 0.223.0

package/src/testing/file-provider-contract.ts

@@ -90,6 +90,25 @@ export function describeFileProviderContract(
       await expect(it.next()).rejects.toThrow();
     });
 
+    test("list returns only keys under the given prefix", async () => {
+      const group = `contract/list-${crypto.randomUUID()}`;
+      const keyA = `${group}/a.txt`;
+      const keyB = `${group}/b.txt`;
+      const outsideKey = `contract/list-${crypto.randomUUID()}/c.txt`;
+      writtenKeys.push(keyA, keyB, outsideKey);
+      await provider.write(keyA, bytes("a"));
+      await provider.write(keyB, bytes("b"));
+      await provider.write(outsideKey, bytes("c"));
+
+      const listed = await provider.list(`${group}/`);
+      expect(new Set(listed)).toEqual(new Set([keyA, keyB]));
+    });
+
+    test("list on a prefix with no matches returns an empty array", async () => {
+      const listed = await provider.list(`contract/list-missing-${crypto.randomUUID()}/`);
+      expect(listed).toEqual([]);
+    });
+
     test("getSignedUrl, when implemented, returns a URL string", async () => {
       // skip: getSignedUrl is optional on the contract — feature-detected
       if (!provider.getSignedUrl) return;

package/src/upgrade-cli.ts

@@ -271,10 +271,15 @@ type UpgradeMarkerCodemod = {
   readonly codemod: string;
   readonly title: string;
 };
+type UpgradeMarkerManual = {
+  readonly version: string;
+  readonly title: string;
+};
 type UpgradeMarker = {
   readonly version: string;
   readonly appliedAt: string;
   readonly codemods: readonly UpgradeMarkerCodemod[];
+  readonly pendingManual?: readonly UpgradeMarkerManual[];
 };
 
 function writeUpgradeMarker(targetDir: string, marker: UpgradeMarker): void {
@@ -324,6 +329,7 @@ function markerVersionForPending(
 // failure — no partial marker. Writes the marker whenever dryRun is false —
 // even with zero pending entries, so an already-current app still gets a
 // bootstrap marker recording its installed version (fw#2299).
+// kumiko-lint-ignore complexity-budget sequential codemod runner with zero-pending bootstrap marker
 async function applyCodemods(
   out: UpgradeCliOut,
   pending: readonly ChangelogEntry[],
@@ -352,7 +358,7 @@ async function applyCodemods(
   const codemodEntries = breaking
     .filter(hasCodemod)
     .sort((a, b) => compareVersions(a.version, b.version));
-  const manualEntries = breaking.filter((e) => !e.codemod);
+  const manualEntries = breaking.filter((e) => !hasCodemod(e));
 
   for (const e of manualEntries) {
     out.log(`  ⚠ ${e.version} · ${e.title} — no codemod, manual migration required`);
@@ -407,14 +413,19 @@ async function applyCodemods(
   }
 
   const latestVersion = markerVersionForPending(pending, manualEntries, markerVersion);
+  const pendingManual = manualEntries.map((e) => ({ version: e.version, title: e.title }));
   writeUpgradeMarker(targetDir, {
     version: latestVersion,
     appliedAt: Temporal.Now.instant().toString(),
     codemods: ran,
+    ...(pendingManual.length > 0 && { pendingManual }),
   });
   out.log(
     `  ✓ Applied ${ran.length} codemod(s). Wrote ${join(targetDir, ".kumiko/upgrade-state.json")}`,
   );
+  if (pendingManual.length > 0) {
+    out.log(`  ⚠ ${pendingManual.length} breaking change(s) still need manual migration.`);
+  }
   return 0;
 }