mewkit 1.13.0 → 1.14.0

package/dist/migrate/reconcile/portable-registry.d.ts

@@ -18,30 +18,30 @@ declare const PortableInstallationSchemaV3: z.ZodObject<{
     installedChecksum: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     path: string;
-    type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+    type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
     installedAt: string;
-    global: boolean;
+    item: string;
     provider: string;
+    global: boolean;
     sourcePath: string;
-    item: string;
     sourceChecksum: string;
     targetChecksum: string;
-    installSource: "manual" | "kit";
+    installSource: "kit" | "manual";
     installedVersion?: string | undefined;
     cliVersion?: string | undefined;
     ownedSections?: string[] | undefined;
     installedChecksum?: string | undefined;
 }, {
     path: string;
-    type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+    type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
     installedAt: string;
-    global: boolean;
+    item: string;
     provider: string;
+    global: boolean;
     sourcePath: string;
-    item: string;
     sourceChecksum: string;
     targetChecksum: string;
-    installSource: "manual" | "kit";
+    installSource: "kit" | "manual";
     installedVersion?: string | undefined;
     cliVersion?: string | undefined;
     ownedSections?: string[] | undefined;
@@ -67,30 +67,30 @@ declare const PortableRegistrySchemaV3: z.ZodObject<{
         installedChecksum: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         path: string;
-        type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+        type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
         installedAt: string;
-        global: boolean;
+        item: string;
         provider: string;
+        global: boolean;
         sourcePath: string;
-        item: string;
         sourceChecksum: string;
         targetChecksum: string;
-        installSource: "manual" | "kit";
+        installSource: "kit" | "manual";
         installedVersion?: string | undefined;
         cliVersion?: string | undefined;
         ownedSections?: string[] | undefined;
         installedChecksum?: string | undefined;
     }, {
         path: string;
-        type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+        type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
         installedAt: string;
-        global: boolean;
+        item: string;
         provider: string;
+        global: boolean;
         sourcePath: string;
-        item: string;
         sourceChecksum: string;
         targetChecksum: string;
-        installSource: "manual" | "kit";
+        installSource: "kit" | "manual";
         installedVersion?: string | undefined;
         cliVersion?: string | undefined;
         ownedSections?: string[] | undefined;
@@ -102,15 +102,15 @@ declare const PortableRegistrySchemaV3: z.ZodObject<{
     version: "3.0";
     installations: {
         path: string;
-        type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+        type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
         installedAt: string;
-        global: boolean;
+        item: string;
         provider: string;
+        global: boolean;
         sourcePath: string;
-        item: string;
         sourceChecksum: string;
         targetChecksum: string;
-        installSource: "manual" | "kit";
+        installSource: "kit" | "manual";
         installedVersion?: string | undefined;
         cliVersion?: string | undefined;
         ownedSections?: string[] | undefined;
@@ -122,15 +122,15 @@ declare const PortableRegistrySchemaV3: z.ZodObject<{
     version: "3.0";
     installations: {
         path: string;
-        type: "skill" | "hooks" | "rules" | "agent" | "command" | "config";
+        type: "agent" | "command" | "skill" | "config" | "rules" | "hooks";
         installedAt: string;
-        global: boolean;
+        item: string;
         provider: string;
+        global: boolean;
         sourcePath: string;
-        item: string;
         sourceChecksum: string;
         targetChecksum: string;
-        installSource: "manual" | "kit";
+        installSource: "kit" | "manual";
         installedVersion?: string | undefined;
         cliVersion?: string | undefined;
         ownedSections?: string[] | undefined;

package/dist/migrate/reconcile/process-lock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-lock.d.ts","sourceRoot":"","sources":["../../../src/migrate/reconcile/process-lock.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAmBD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsClG;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM1E"}
+{"version":3,"file":"process-lock.d.ts","sourceRoot":"","sources":["../../../src/migrate/reconcile/process-lock.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,KAAK,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC5B;AAmBD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsClG;AAED,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1E"}

package/dist/migrate/reconcile/process-lock.js

@@ -1,7 +1,7 @@
 // Process-wide migration lock (Red Team Finding 13). Prevents two `mewkit migrate` runs
 // from racing on the same registry. Uses a PID file with stale-detection via process.kill(0).
 import { existsSync } from "node:fs";
-import { mkdir, readFile, unlink, writeFile } from "node:fs/promises";
+import { mkdir, readFile, rmdir, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 /** Resolve lock path at call time so `process.cwd()` reflects the actual invocation
@@ -74,5 +74,14 @@ export async function releaseMigrationLock(lockPath) {
     catch {
         // Best-effort
     }
+    // Leave no empty lock directory behind in the target project. rmdir only
+    // succeeds on an empty directory, so a home-scope dir that also holds the
+    // portable registry is untouched.
+    try {
+        await rmdir(dirname(lockPath));
+    }
+    catch {
+        // Non-empty or already gone — fine.
+    }
 }
 //# sourceMappingURL=process-lock.js.map

package/dist/migrate/reconcile/process-lock.js.map

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

package/dist/migrate/references/codex-command-skill-path.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Skill directory name for a migrated command (e.g. "mk/fix" → "source-command-mk-fix").
+ *
+ * The encoding is injective over the realistic name alphabet [a-z0-9-/_.]:
+ * literal hyphens are doubled BEFORE path separators become single hyphens, so
+ * a nested "mk/fix" and a flat "mk-fix" cannot collide (which would otherwise
+ * make one command's install silently overwrite the other's).
+ */
+export declare function codexCommandSkillDirName(commandName: string): string;
+/** Path of the generated skill file relative to the provider skills root */
+export declare function codexCommandSkillRelativePath(commandName: string): string;
+//# sourceMappingURL=codex-command-skill-path.d.ts.map

package/dist/migrate/references/codex-command-skill-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-command-skill-path.d.ts","sourceRoot":"","sources":["../../../src/migrate/references/codex-command-skill-path.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUpE;AAED,4EAA4E;AAC5E,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/migrate/references/codex-command-skill-path.js

@@ -0,0 +1,27 @@
+// Pure path helpers for the Codex command→skill mapping. Dependency-free so
+// both the converter and the reference/path registries can import them without
+// creating an import cycle.
+/**
+ * Skill directory name for a migrated command (e.g. "mk/fix" → "source-command-mk-fix").
+ *
+ * The encoding is injective over the realistic name alphabet [a-z0-9-/_.]:
+ * literal hyphens are doubled BEFORE path separators become single hyphens, so
+ * a nested "mk/fix" and a flat "mk-fix" cannot collide (which would otherwise
+ * make one command's install silently overwrite the other's).
+ */
+export function codexCommandSkillDirName(commandName) {
+    const slug = commandName
+        .replace(/\\/g, "/")
+        .toLowerCase()
+        .replace(/\.md$/, "")
+        .replace(/-/g, "--")
+        .replace(/\//g, "-")
+        .replace(/[^a-z0-9-]/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return `source-command-${slug || "unnamed"}`;
+}
+/** Path of the generated skill file relative to the provider skills root */
+export function codexCommandSkillRelativePath(commandName) {
+    return `${codexCommandSkillDirName(commandName)}/SKILL.md`;
+}
+//# sourceMappingURL=codex-command-skill-path.js.map

package/dist/migrate/references/codex-command-skill-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-command-skill-path.js","sourceRoot":"","sources":["../../../src/migrate/references/codex-command-skill-path.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,+EAA+E;AAC/E,4BAA4B;AAE5B;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,WAAmB;IAC3D,MAAM,IAAI,GAAG,WAAW;SACtB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1B,OAAO,kBAAkB,IAAI,IAAI,SAAS,EAAE,CAAC;AAC9C,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,6BAA6B,CAAC,WAAmB;IAChE,OAAO,GAAG,wBAAwB,CAAC,WAAW,CAAC,WAAW,CAAC;AAC5D,CAAC"}

package/dist/migrate/references/fence-aware-reference-rewriter.d.ts

@@ -0,0 +1,30 @@
+import { type ReferenceScope } from "./reference-target-registry.js";
+import type { ReferenceOccurrence } from "./reference-types.js";
+import type { ProviderType } from "../types.js";
+/** Membership test over the set of source assets included in the current migration */
+export interface ReferenceIntegrityIndex {
+    has(sourceRelativePath: string): boolean;
+}
+/**
+ * Build an integrity index from source-relative entries. Entries ending with
+ * "/" match as directory prefixes (e.g. ".claude/skills/demo-skill/").
+ */
+export declare function createReferenceIntegrityIndex(entries: Iterable<string>): ReferenceIntegrityIndex;
+export declare function combineIntegrityIndexes(...indexes: Array<ReferenceIntegrityIndex | null | undefined>): ReferenceIntegrityIndex;
+export interface SourceReferenceRewriteOptions {
+    provider?: ProviderType;
+    scope?: ReferenceScope;
+    /** Filename recorded on occurrences (for report output) */
+    file?: string;
+    /** Migration-set membership; absent = unknown → fenced refs are preserved + warned */
+    migratedRefs?: ReferenceIntegrityIndex | null;
+    /** "code" treats the whole content as runnable (fenced semantics, no prose spans) */
+    contentKind?: "markdown" | "code";
+}
+export interface SourceReferenceRewriteResult {
+    content: string;
+    occurrences: ReferenceOccurrence[];
+    warnings: string[];
+}
+export declare function rewriteSourceReferences(content: string, options: SourceReferenceRewriteOptions): SourceReferenceRewriteResult;
+//# sourceMappingURL=fence-aware-reference-rewriter.d.ts.map

package/dist/migrate/references/fence-aware-reference-rewriter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fence-aware-reference-rewriter.d.ts","sourceRoot":"","sources":["../../../src/migrate/references/fence-aware-reference-rewriter.ts"],"names":[],"mappings":"AAeA,OAAO,EAON,KAAK,cAAc,EACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,mBAAmB,EAAiB,MAAM,sBAAsB,CAAC;AAC/E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,sFAAsF;AACtF,MAAM,WAAW,uBAAuB;IACvC,GAAG,CAAC,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAehG;AAED,wBAAgB,uBAAuB,CACtC,GAAG,OAAO,EAAE,KAAK,CAAC,uBAAuB,GAAG,IAAI,GAAG,SAAS,CAAC,GAC3D,uBAAuB,CAGzB;AAED,MAAM,WAAW,6BAA6B;IAC7C,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,2DAA2D;IAC3D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sFAAsF;IACtF,YAAY,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC9C,qFAAqF;IACrF,WAAW,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,4BAA4B;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,EAAE,CAAC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACnB;AAwDD,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,6BAA6B,GACpC,4BAA4B,CA0G9B"}

package/dist/migrate/references/fence-aware-reference-rewriter.js

@@ -0,0 +1,182 @@
+// Fence-aware source-reference rewriter. Replaces the old binary rule
+// ("fence = preserve everything" / "direct-copy = replace everything") with a
+// span-based decision matrix:
+//
+//   span            mapped asset                  unmapped runtime      citation
+//   prose/inline    rewrite to target             neutralize + record   preserve
+//   frontmatter     rewrite to target             neutralize + record   preserve
+//   fenced/code     rewrite ONLY when the asset   preserve + warn       preserve
+//                   is in the migration set,
+//                   else preserve + warn
+//
+// Runnable content is never given a fabricated path: a fenced reference is only
+// rewritten when the referenced asset is provably part of the migration set.
+import { buildMarkdownSpanMap } from "./reference-classifier.js";
+import { SOURCE_ROOT, buildReferenceRewriteTable, resolveReferenceTarget, sourceConfigTokenPattern, sourceReferencePattern, } from "./reference-target-registry.js";
+/**
+ * Build an integrity index from source-relative entries. Entries ending with
+ * "/" match as directory prefixes (e.g. ".claude/skills/demo-skill/").
+ */
+export function createReferenceIntegrityIndex(entries) {
+    const files = new Set();
+    const prefixes = [];
+    for (const entry of entries) {
+        const normalized = entry.replace(/\\/g, "/");
+        if (normalized.endsWith("/"))
+            prefixes.push(normalized.toLowerCase());
+        else
+            files.add(normalized.toLowerCase());
+    }
+    return {
+        has(sourceRelativePath) {
+            const normalized = sourceRelativePath.replace(/\\/g, "/").toLowerCase();
+            if (files.has(normalized))
+                return true;
+            return prefixes.some((prefix) => normalized.startsWith(prefix));
+        },
+    };
+}
+export function combineIntegrityIndexes(...indexes) {
+    const present = indexes.filter((index) => Boolean(index));
+    return { has: (path) => present.some((index) => index.has(path)) };
+}
+const TYPE_DIRS = ["agents", "commands", "skills", "rules", "hooks"];
+// Provider-neutral phrases used when a reference has no provider target.
+const NEUTRAL_TYPE_PHRASE = {
+    rules: "project rules directory/",
+    agents: "project subagents directory/",
+    commands: "project commands directory/",
+    skills: "project skills directory/",
+    hooks: "project hooks directory/",
+};
+const NEUTRAL_ROOT_PHRASE = "project runtime data/";
+const NEUTRAL_CONFIG_PHRASE = "project configuration file";
+function classifySourcePath(path, table) {
+    const suffix = path.slice(SOURCE_ROOT.length);
+    const typeDir = TYPE_DIRS.find((dir) => suffix.toLowerCase().startsWith(`${dir}/`));
+    const target = resolveReferenceTarget(table, path);
+    if (target !== null) {
+        const rule = table.find((r) => path.toLowerCase().startsWith(r.sourcePrefix.toLowerCase()));
+        return {
+            kind: "mapped-asset",
+            target,
+            preservesSuffix: rule?.target?.isDirectory ?? false,
+            neutral: "",
+            reason: "",
+        };
+    }
+    if (typeDir) {
+        return {
+            kind: "unmapped-runtime",
+            target: null,
+            preservesSuffix: false,
+            neutral: `${NEUTRAL_TYPE_PHRASE[typeDir]}${suffix.slice(typeDir.length + 1)}`,
+            reason: `provider has no ${typeDir} surface`,
+        };
+    }
+    return {
+        kind: "unmapped-runtime",
+        target: null,
+        preservesSuffix: false,
+        neutral: `${NEUTRAL_ROOT_PHRASE}${suffix}`,
+        reason: "no provider equivalent for this source runtime path",
+    };
+}
+export function rewriteSourceReferences(content, options) {
+    const table = buildReferenceRewriteTable(options.provider, options.scope ?? "project");
+    const occurrences = [];
+    const warnings = [];
+    const file = options.file ?? "";
+    const record = (occurrence) => {
+        occurrences.push(occurrence);
+        if (occurrence.decision === "preserve-warn") {
+            warnings.push(`Unresolved reference preserved (line ${occurrence.line}): "${occurrence.original}" — ${occurrence.reason}`);
+        }
+    };
+    // Each replace pass shifts byte offsets, so the span map is rebuilt per pass.
+    const buildSpanHelpers = (input) => {
+        const spanMap = options.contentKind === "code" ? null : buildMarkdownSpanMap(input);
+        return {
+            spanAt: (offset) => spanMap?.spanAt(offset) ?? "fenced",
+            lineAt: (offset) => {
+                if (spanMap)
+                    return spanMap.lineNumberAt(offset);
+                let line = 1;
+                for (let i = 0; i < offset && i < input.length; i++)
+                    if (input[i] === "\n")
+                        line++;
+                return line;
+            },
+            isCitationAt: (offset) => spanMap?.isCitationAt(offset) ?? false,
+        };
+    };
+    let { spanAt, lineAt, isCitationAt } = buildSpanHelpers(content);
+    let result = content.replace(sourceReferencePattern(), (matched, ...args) => {
+        const offset = args[args.length - 2];
+        const span = spanAt(offset);
+        const line = lineAt(offset);
+        const base = { file, line, span, original: matched };
+        if (isCitationAt(offset)) {
+            record({ ...base, kind: "citation", decision: "preserve" });
+            return matched;
+        }
+        const classified = classifySourcePath(matched, table);
+        const runnable = span === "fenced";
+        if (!runnable) {
+            if (classified.kind === "mapped-asset" && classified.target !== null) {
+                record({ ...base, kind: "mapped-asset", decision: "rewrite", rewrittenTo: classified.target });
+                return classified.target;
+            }
+            record({
+                ...base,
+                kind: "unmapped-runtime",
+                decision: "rewrite",
+                rewrittenTo: classified.neutral,
+                reason: `${classified.reason}; neutralized`,
+            });
+            return classified.neutral;
+        }
+        // Runnable content: rewrite only with proof the referenced asset migrates
+        // too AND the target keeps the file suffix — a merged/non-directory target
+        // cannot express the file's real location, so rewriting would fabricate.
+        if (classified.kind === "mapped-asset" && classified.target !== null) {
+            if (classified.preservesSuffix && options.migratedRefs?.has(matched)) {
+                record({ ...base, kind: "mapped-asset", decision: "rewrite", rewrittenTo: classified.target });
+                return classified.target;
+            }
+            record({
+                ...base,
+                kind: "mapped-asset",
+                decision: "preserve-warn",
+                reason: classified.preservesSuffix
+                    ? "referenced asset is not part of this migration; left unchanged instead of guessing a target path"
+                    : "target surface is merged/non-directory; original path preserved to avoid a fabricated location",
+            });
+            return matched;
+        }
+        record({ ...base, kind: "unmapped-runtime", decision: "preserve-warn", reason: classified.reason });
+        return matched;
+    });
+    ({ spanAt, lineAt, isCitationAt } = buildSpanHelpers(result));
+    const configTarget = resolveReferenceTarget(table, "CLAUDE.md");
+    const configReplacement = configTarget ?? NEUTRAL_CONFIG_PHRASE;
+    result = result.replace(sourceConfigTokenPattern(), (matched, ...args) => {
+        const offset = args[args.length - 2];
+        const span = spanAt(offset);
+        const line = lineAt(offset);
+        const base = { file, line, span, original: matched };
+        if (isCitationAt(offset)) {
+            record({ ...base, kind: "citation", decision: "preserve" });
+            return matched;
+        }
+        if (span === "fenced") {
+            // Command examples keep the literal token — a rename would break the example.
+            record({ ...base, kind: "mapped-asset", decision: "preserve" });
+            return matched;
+        }
+        record({ ...base, kind: "mapped-asset", decision: "rewrite", rewrittenTo: configReplacement });
+        return configReplacement;
+    });
+    return { content: result, occurrences, warnings };
+}
+//# sourceMappingURL=fence-aware-reference-rewriter.js.map

package/dist/migrate/references/fence-aware-reference-rewriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fence-aware-reference-rewriter.js","sourceRoot":"","sources":["../../../src/migrate/references/fence-aware-reference-rewriter.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,8EAA8E;AAC9E,8BAA8B;AAC9B,EAAE;AACF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AACjF,6CAA6C;AAC7C,yCAAyC;AACzC,EAAE;AACF,gFAAgF;AAChF,6EAA6E;AAE7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EACN,WAAW,EACX,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,GAGtB,MAAM,gCAAgC,CAAC;AASxC;;;GAGG;AACH,MAAM,UAAU,6BAA6B,CAAC,OAAyB;IACtE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;;YACjE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO;QACN,GAAG,CAAC,kBAA0B;YAC7B,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;YACxE,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACjE,CAAC;KACD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,GAAG,OAA0D;IAE7D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAoC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAmBD,MAAM,SAAS,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAU,CAAC;AAE9E,yEAAyE;AACzE,MAAM,mBAAmB,GAA+C;IACvE,KAAK,EAAE,0BAA0B;IACjC,MAAM,EAAE,8BAA8B;IACtC,QAAQ,EAAE,6BAA6B;IACvC,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,0BAA0B;CACjC,CAAC;AACF,MAAM,mBAAmB,GAAG,uBAAuB,CAAC;AACpD,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAW3D,SAAS,kBAAkB,CAAC,IAAY,EAAE,KAA6B;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC;IACpF,MAAM,MAAM,GAAG,sBAAsB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;QAC5F,OAAO;YACN,IAAI,EAAE,cAAc;YACpB,MAAM;YACN,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,IAAI,KAAK;YACnD,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;SACV,CAAC;IACH,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACb,OAAO;YACN,IAAI,EAAE,kBAAkB;YACxB,MAAM,EAAE,IAAI;YACZ,eAAe,EAAE,KAAK;YACtB,OAAO,EAAE,GAAG,mBAAmB,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE;YAC7E,MAAM,EAAE,mBAAmB,OAAO,UAAU;SAC5C,CAAC;IACH,CAAC;IACD,OAAO;QACN,IAAI,EAAE,kBAAkB;QACxB,MAAM,EAAE,IAAI;QACZ,eAAe,EAAE,KAAK;QACtB,OAAO,EAAE,GAAG,mBAAmB,GAAG,MAAM,EAAE;QAC1C,MAAM,EAAE,qDAAqD;KAC7D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CACtC,OAAe,EACf,OAAsC;IAEtC,MAAM,KAAK,GAAG,0BAA0B,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;IACvF,MAAM,WAAW,GAA0B,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAEhC,MAAM,MAAM,GAAG,CAAC,UAA+B,EAAQ,EAAE;QACxD,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC7B,IAAI,UAAU,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YAC7C,QAAQ,CAAC,IAAI,CACZ,wCAAwC,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,QAAQ,OAAO,UAAU,CAAC,MAAM,EAAE,CAC3G,CAAC;QACH,CAAC;IACF,CAAC,CAAC;IAEF,8EAA8E;IAC9E,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAE,EAAE;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACpF,OAAO;YACN,MAAM,EAAE,CAAC,MAAc,EAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,QAAQ;YAC9E,MAAM,EAAE,CAAC,MAAc,EAAU,EAAE;gBAClC,IAAI,OAAO;oBAAE,OAAO,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACjD,IAAI,IAAI,GAAG,CAAC,CAAC;gBACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;oBAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;wBAAE,IAAI,EAAE,CAAC;gBACnF,OAAO,IAAI,CAAC;YACb,CAAC;YACD,YAAY,EAAE,CAAC,MAAc,EAAW,EAAE,CAAC,OAAO,EAAE,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK;SACjF,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAEjE,IAAI,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAW,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAErD,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC;QAChB,CAAC;QAED,MAAM,UAAU,GAAG,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,IAAI,KAAK,QAAQ,CAAC;QAEnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;gBACtE,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/F,OAAO,UAAU,CAAC,MAAM,CAAC;YAC1B,CAAC;YACD,MAAM,CAAC;gBACN,GAAG,IAAI;gBACP,IAAI,EAAE,kBAAkB;gBACxB,QAAQ,EAAE,SAAS;gBACnB,WAAW,EAAE,UAAU,CAAC,OAAO;gBAC/B,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,eAAe;aAC3C,CAAC,CAAC;YACH,OAAO,UAAU,CAAC,OAAO,CAAC;QAC3B,CAAC;QAED,0EAA0E;QAC1E,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,IAAI,UAAU,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACtE,IAAI,UAAU,CAAC,eAAe,IAAI,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtE,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;gBAC/F,OAAO,UAAU,CAAC,MAAM,CAAC;YAC1B,CAAC;YACD,MAAM,CAAC;gBACN,GAAG,IAAI;gBACP,IAAI,EAAE,cAAc;gBACpB,QAAQ,EAAE,eAAe;gBACzB,MAAM,EAAE,UAAU,CAAC,eAAe;oBACjC,CAAC,CAAC,kGAAkG;oBACpG,CAAC,CAAC,gGAAgG;aACnG,CAAC,CAAC;YACH,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC,CAAC;IAEH,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAChE,MAAM,iBAAiB,GAAG,YAAY,IAAI,qBAAqB,CAAC;IAChE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,OAAO,EAAE,GAAG,IAAI,EAAE,EAAE;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAW,CAAC;QAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QAErD,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAC5D,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvB,8EAA8E;YAC9E,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC;YAChE,OAAO,OAAO,CAAC;QAChB,CAAC;QACD,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC/F,OAAO,iBAAiB,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACnD,CAAC"}

package/dist/migrate/references/reference-classifier.d.ts

@@ -0,0 +1,12 @@
+import type { ReferenceSpan } from "./reference-types.js";
+export declare function isCitationLine(line: string): boolean;
+export interface MarkdownSpanMap {
+    /** Span type at a byte offset in the original content */
+    spanAt(offset: number): ReferenceSpan;
+    /** 1-based line number at a byte offset */
+    lineNumberAt(offset: number): number;
+    /** Whether the line containing the offset is a citation/attribution line */
+    isCitationAt(offset: number): boolean;
+}
+export declare function buildMarkdownSpanMap(content: string): MarkdownSpanMap;
+//# sourceMappingURL=reference-classifier.d.ts.map

package/dist/migrate/references/reference-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-classifier.d.ts","sourceRoot":"","sources":["../../../src/migrate/references/reference-classifier.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAc1D,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKpD;AAID,MAAM,WAAW,eAAe;IAC/B,yDAAyD;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IACtC,2CAA2C;IAC3C,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,4EAA4E;IAC5E,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CACtC;AAuFD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,CAkCrE"}

package/dist/migrate/references/reference-classifier.js

@@ -0,0 +1,144 @@
+// Markdown span tokenizer + citation detection for source-reference rewriting.
+// Span resolution is line-based (frontmatter / fenced) with per-line inline-code
+// detection. Ambiguous structures (unclosed fences) resolve to "fenced" so the
+// rewriter stays conservative — never rewrite on uncertainty.
+const FENCE_OPEN = /^ {0,3}(`{3,}|~{3,})/;
+const FRONTMATTER_DELIMITER = /^---\s*$/;
+// A line is a citation when it leads with an attribution verb, or is a
+// blockquote carrying an external URL or a repo slug next to an attribution dash.
+const CITATION_LEAD = /^(?:>\s*)*(?:source|from|ported\s+from)\b/i;
+const BLOCKQUOTE = /^\s*>/;
+const EXTERNAL_URL = /https?:\/\//i;
+// Repo slug like "org/repo"; the lookbehind rejects path segments (".claude/rules", "a/b/c").
+const REPO_SLUG = /(?<![\w./])[a-z0-9][\w.-]*\/[a-z0-9][\w.-]*(?![\w/])/i;
+const ATTRIBUTION_DASH = /[—–]/;
+export function isCitationLine(line) {
+    const trimmed = line.trim();
+    if (CITATION_LEAD.test(trimmed))
+        return true;
+    if (!BLOCKQUOTE.test(trimmed))
+        return false;
+    return EXTERNAL_URL.test(trimmed) || (REPO_SLUG.test(trimmed) && ATTRIBUTION_DASH.test(trimmed));
+}
+function buildLineStarts(content) {
+    const starts = [0];
+    for (let i = 0; i < content.length; i++) {
+        if (content[i] === "\n")
+            starts.push(i + 1);
+    }
+    return starts;
+}
+function lineIndexAt(lineStarts, offset) {
+    let lo = 0;
+    let hi = lineStarts.length - 1;
+    while (lo < hi) {
+        const mid = (lo + hi + 1) >> 1;
+        if (lineStarts[mid] <= offset)
+            lo = mid;
+        else
+            hi = mid - 1;
+    }
+    return lo;
+}
+function classifyLines(lines) {
+    const kinds = new Array(lines.length).fill("other");
+    let i = 0;
+    if (lines.length > 0 && FRONTMATTER_DELIMITER.test(lines[0])) {
+        const close = lines.findIndex((line, idx) => idx > 0 && FRONTMATTER_DELIMITER.test(line));
+        if (close > 0) {
+            for (let j = 0; j <= close; j++)
+                kinds[j] = "frontmatter";
+            i = close + 1;
+        }
+    }
+    let fenceMarker = null;
+    for (; i < lines.length; i++) {
+        const line = lines[i];
+        if (fenceMarker) {
+            kinds[i] = "fenced";
+            const close = line.match(FENCE_OPEN);
+            if (close && close[1][0] === fenceMarker.char && close[1].length >= fenceMarker.length && !line.trim().slice(close[1].length)) {
+                fenceMarker = null;
+            }
+            continue;
+        }
+        const open = line.match(FENCE_OPEN);
+        if (open) {
+            kinds[i] = "fenced";
+            fenceMarker = { char: open[1][0], length: open[1].length };
+        }
+    }
+    // An unclosed fence leaves fenceMarker set — remaining lines were already
+    // marked fenced inside the loop, which is the conservative resolution.
+    return kinds;
+}
+/** Inline code span ranges (column offsets, delimiters included) for one line. */
+function inlineCodeRanges(line) {
+    const ranges = [];
+    let i = 0;
+    while (i < line.length) {
+        if (line[i] !== "`") {
+            i++;
+            continue;
+        }
+        let openLen = 0;
+        while (line[i + openLen] === "`")
+            openLen++;
+        const openEnd = i + openLen;
+        // Find a closing run of the same length.
+        let j = openEnd;
+        while (j < line.length) {
+            if (line[j] !== "`") {
+                j++;
+                continue;
+            }
+            let runLen = 0;
+            while (line[j + runLen] === "`")
+                runLen++;
+            if (runLen === openLen) {
+                ranges.push([i, j + runLen]);
+                break;
+            }
+            j += runLen;
+        }
+        i = j < line.length ? j + openLen : openEnd;
+    }
+    return ranges;
+}
+export function buildMarkdownSpanMap(content) {
+    const lines = content.split("\n");
+    const lineStarts = buildLineStarts(content);
+    const lineKinds = classifyLines(lines);
+    const citationCache = new Map();
+    const inlineCache = new Map();
+    return {
+        spanAt(offset) {
+            const lineIdx = lineIndexAt(lineStarts, offset);
+            const kind = lineKinds[lineIdx];
+            if (kind === "frontmatter")
+                return "frontmatter";
+            if (kind === "fenced")
+                return "fenced";
+            let ranges = inlineCache.get(lineIdx);
+            if (!ranges) {
+                ranges = inlineCodeRanges(lines[lineIdx]);
+                inlineCache.set(lineIdx, ranges);
+            }
+            const column = offset - lineStarts[lineIdx];
+            return ranges.some(([start, end]) => column >= start && column < end) ? "inline-code" : "prose";
+        },
+        lineNumberAt(offset) {
+            return lineIndexAt(lineStarts, offset) + 1;
+        },
+        isCitationAt(offset) {
+            const lineIdx = lineIndexAt(lineStarts, offset);
+            let cached = citationCache.get(lineIdx);
+            if (cached === undefined) {
+                cached = isCitationLine(lines[lineIdx]);
+                citationCache.set(lineIdx, cached);
+            }
+            return cached;
+        },
+    };
+}
+//# sourceMappingURL=reference-classifier.js.map

package/dist/migrate/references/reference-classifier.js.map

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