mewkit 1.13.0 → 1.14.1

package/dist/migrate/validation/migration-ledger-inputs.js

@@ -0,0 +1,160 @@
+// Aggregation: fold the migration run's already-scattered signals into a single
+// list of per-artifact `MigrationDecisionRecord`s for the run-report ledger. This
+// is pure aggregation — no new detection. The identity invariant the report relies
+// on (migrated + skipped + failed == discovered artifacts) is guaranteed here by
+// emitting exactly one PRIMARY record per discovered artifact, with Phase 1-3
+// sub-signals (preserved references, waivers, audit failures) enriching — never
+// inflating — those primary records.
+import { classifyEnvReference } from "../references/reference-classifier.js";
+/**
+ * Enumerate every discovered source artifact as `{source, type}`. This is the
+ * identity-check denominator: every entry here becomes exactly one primary record.
+ * Shell hooks filtered out at discovery are included as skipped artifacts so the
+ * dropped-safety-hook loss (gate-enforcement, privacy-block, …) is never silent.
+ */
+export function enumerateDiscoveredArtifacts(discovered) {
+    const artifacts = [];
+    for (const a of discovered.agents)
+        artifacts.push({ source: a.name, type: "agent" });
+    for (const c of discovered.commands)
+        artifacts.push({ source: c.name, type: "command" });
+    for (const r of discovered.rules)
+        artifacts.push({ source: r.name, type: "rules" });
+    if (discovered.config)
+        artifacts.push({ source: discovered.config.name, type: "config" });
+    for (const s of discovered.skills)
+        artifacts.push({ source: s.name, type: "skill" });
+    for (const h of discovered.hooks)
+        artifacts.push({ source: h.name, type: "hooks" });
+    for (const shellHook of discovered.skippedShellHooks)
+        artifacts.push({ source: shellHook, type: "hooks" });
+    return artifacts;
+}
+function outcomeKey(type, source) {
+    return `${type}:${source}`;
+}
+/** Human reason for a run outcome, routing `.env` references through the new classifier. */
+function reasonForOutcome(outcome) {
+    if (outcome.outcome === "migrated")
+        return { reason: "converted" };
+    const detail = outcome.internalError ? `internal-error: ${outcome.error ?? "unknown"}` : outcome.error;
+    return { reason: "conversion-error", detail };
+}
+/**
+ * Reclassify a preserved occurrence's report reason: a `.claude/.env` reference now
+ * points at the emitted [shell_environment_policy] scaffold instead of the stale
+ * "no provider equivalent" phrase. Item D — routed ONLY here (report-reason layer),
+ * never in the rewriter's decision rules.
+ */
+export function reportReasonForOccurrence(occurrence) {
+    const envReason = classifyEnvReference(occurrence.original);
+    if (envReason)
+        return envReason.reason;
+    return occurrence.reason ?? "reference preserved";
+}
+/** Owning artifact key for an occurrence whose `file` is a `provider/type/item…` path. */
+function occurrenceArtifact(occurrence) {
+    // Occurrence file forms produced by the conversion pass:
+    //   `<provider>/<type>/<item>`                     (agents, commands, rules, config)
+    //   `<provider>/skill/<skillName>/<relPath>`       (skill files)
+    const parts = occurrence.file.split("/");
+    if (parts.length < 3)
+        return null;
+    const type = parts[1];
+    if (type === "skill")
+        return { type: "skill", source: parts[2] };
+    if (type === "agent" || type === "command" || type === "rules" || type === "config" || type === "hooks") {
+        return { type, source: parts[2] };
+    }
+    return null;
+}
+/**
+ * Build the complete per-discovered-artifact record list. Exactly one primary
+ * record per discovered artifact (identity invariant). Phase records that carry a
+ * more severe outcome for the same artifact escalate the primary record's status;
+ * preserved occurrences attach as enrichment on the owning primary record.
+ */
+export function buildRunRecords(input) {
+    const OUTCOME_SEVERITY = { migrated: 0, skipped: 1, partial: 2, failed: 3 };
+    const primary = new Map();
+    // 1. One primary record per discovered artifact.
+    for (const artifact of enumerateDiscoveredArtifacts(input.discovered)) {
+        const key = outcomeKey(artifact.type, artifact.source);
+        const outcome = input.outcomes.get(key);
+        let record;
+        if (!outcome) {
+            // No install attempt reached this artifact (filtered by portability policy,
+            // no provider surface, or a skipped shell hook): a deliberate skip.
+            record = {
+                source: artifact.source,
+                type: artifact.type,
+                provider: input.provider,
+                outcome: "skipped",
+                reason: artifact.type === "hooks" ? "event-unsupported" : "no-provider-surface",
+            };
+        }
+        else {
+            const { reason, detail } = reasonForOutcome(outcome);
+            record = {
+                source: artifact.source,
+                type: artifact.type,
+                provider: input.provider,
+                outcome: outcome.outcome,
+                reason,
+            };
+            if (detail)
+                record.detail = detail;
+            if (outcome.target)
+                record.target = outcome.target;
+        }
+        primary.set(key, record);
+    }
+    // 2. Escalate primary outcomes from Phase 1-3 records. Skill/hook sub-records use
+    //    per-file `source` paths; map them back to their owning discovered artifact.
+    const dirNameToSkillName = new Map(input.discovered.skills.map((s) => [s.dirName, s.name]));
+    for (const rec of input.phaseRecords) {
+        const owner = phaseRecordOwner(rec, dirNameToSkillName);
+        if (!owner)
+            continue;
+        const key = outcomeKey(owner.type, owner.source);
+        const existing = primary.get(key);
+        if (!existing)
+            continue;
+        if (OUTCOME_SEVERITY[rec.outcome] > OUTCOME_SEVERITY[existing.outcome]) {
+            existing.outcome = rec.outcome;
+            existing.reason = rec.reason;
+            if (rec.detail)
+                existing.detail = rec.detail;
+        }
+    }
+    // 3. Attach preserved occurrences to their owning primary record for file:line detail.
+    for (const occ of input.preservedOccurrences) {
+        const owner = occurrenceArtifact(occ);
+        if (!owner)
+            continue;
+        const existing = primary.get(outcomeKey(owner.type, owner.source));
+        if (!existing)
+            continue;
+        const enriched = { ...occ, reason: reportReasonForOccurrence(occ) };
+        existing.occurrences = [...(existing.occurrences ?? []), enriched];
+    }
+    return Array.from(primary.values());
+}
+/**
+ * Resolve which discovered artifact a Phase 1-3 sub-record belongs to. Skill
+ * sub-records carry `source: .claude/skills/<dirName>/<file>`; hook records carry
+ * the hook file name directly. The dirName is matched against discovered skill
+ * dirNames so the owner key aligns with the primary record's `source` (skill.name).
+ */
+function phaseRecordOwner(rec, dirNameToSkillName) {
+    if (rec.type === "skill") {
+        const m = rec.source.match(/^\.claude\/skills\/([^/]+)\//);
+        if (m)
+            return { type: "skill", source: dirNameToSkillName.get(m[1]) ?? m[1] };
+        return { type: "skill", source: rec.source };
+    }
+    if (rec.type === "hooks")
+        return { type: "hooks", source: rec.source };
+    return { type: rec.type, source: rec.source };
+}
+//# sourceMappingURL=migration-ledger-inputs.js.map

package/dist/migrate/validation/migration-ledger-inputs.js.map

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

package/dist/migrate/validation/migration-record-types.d.ts

@@ -0,0 +1,38 @@
+import type { ReferenceOccurrence } from "../references/reference-types.js";
+import type { PortableType, ProviderType } from "../types.js";
+/** The outcome the pipeline reached for a single source artifact. */
+export type MigrationOutcome = "migrated" | "skipped" | "failed" | "partial";
+/** Why the pipeline reached a given outcome, coarse enough to group records. */
+export type MigrationReasonCode = "converted" | "no-provider-surface" | "policy-excluded" | "audit-rejected" | "conversion-error" | "reference-preserved" | "runtime-neutralized" | "event-unsupported" | "matcher-narrowed";
+/** One decision about one source artifact, emitted by any migration phase. */
+export interface MigrationDecisionRecord {
+    /** Source-relative identifier of the artifact (e.g. ".claude/agents/planner.md"). */
+    source: string;
+    /** Portable classification of the artifact. */
+    type: PortableType;
+    /** Provider the decision applies to. */
+    provider: ProviderType;
+    /** The outcome the pipeline reached. */
+    outcome: MigrationOutcome;
+    /** Coarse reason grouping for the outcome. */
+    reason: MigrationReasonCode;
+    /** Human-readable detail for the run report (optional). */
+    detail?: string;
+    /** Target-relative path written, when outcome === "migrated" | "partial". */
+    target?: string;
+    /**
+     * Reference occurrences observed while processing this artifact. The fenced-
+     * reference integrity pass is the first producer of these records.
+     */
+    occurrences?: ReferenceOccurrence[];
+}
+/** The serialized decision-record set for one migration run. */
+export interface MigrationRecordSet {
+    /** Provider this run targeted. */
+    provider: ProviderType;
+    /** ISO-8601 timestamp the run completed. */
+    completedAt: string;
+    /** Every per-artifact decision the run made. */
+    decisions: MigrationDecisionRecord[];
+}
+//# sourceMappingURL=migration-record-types.d.ts.map

package/dist/migrate/validation/migration-record-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-record-types.d.ts","sourceRoot":"","sources":["../../../src/migrate/validation/migration-record-types.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE9D,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GACzB,UAAU,GACV,SAAS,GACT,QAAQ,GACR,SAAS,CAAC;AAEb,gFAAgF;AAChF,MAAM,MAAM,mBAAmB,GAC5B,WAAW,GACX,qBAAqB,GACrB,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,kBAAkB,CAAC;AAEtB,8EAA8E;AAC9E,MAAM,WAAW,uBAAuB;IACvC,qFAAqF;IACrF,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,IAAI,EAAE,YAAY,CAAC;IACnB,wCAAwC;IACxC,QAAQ,EAAE,YAAY,CAAC;IACvB,wCAAwC;IACxC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,8CAA8C;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACpC;AAED,gEAAgE;AAChE,MAAM,WAAW,kBAAkB;IAClC,kCAAkC;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,SAAS,EAAE,uBAAuB,EAAE,CAAC;CACrC"}

package/dist/migrate/validation/migration-record-types.js

@@ -0,0 +1,12 @@
+// Shared decision-record data contract for the migration pipeline.
+//
+// Every phase that decides the fate of a source artifact (migrated / skipped /
+// failed / neutralized) emits records that conform to these types; the final
+// run-report layer serializes them into a single "what migrated and why" view.
+// The reference-occurrence stream (below) is the first producer: the fenced-
+// reference integrity pass records one occurrence per classified source ref.
+//
+// These are pure type declarations — no runtime logic. Keep them minimal:
+// producers add the fields they can populate, consumers read what is present.
+export {};
+//# sourceMappingURL=migration-record-types.js.map

package/dist/migrate/validation/migration-record-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-record-types.js","sourceRoot":"","sources":["../../../src/migrate/validation/migration-record-types.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,6EAA6E;AAC7E,EAAE;AACF,0EAA0E;AAC1E,8EAA8E"}

package/dist/migrate/validation/migration-report-writer.d.ts

@@ -0,0 +1,98 @@
+import type { ProviderType } from "../types.js";
+import type { MigrationDecisionRecord } from "./migration-record-types.js";
+/** Bump when the JSON shape changes in a backward-incompatible way. */
+export declare const MIGRATION_REPORT_SCHEMA_VERSION: 1;
+/** Fixed artifact file names (siblings under the provider output dir). */
+export declare const MIGRATION_REPORT_JSON_NAME = "migration-report.json";
+export declare const MIGRATION_REPORT_MD_NAME = "migration-report.md";
+/** One reference occurrence surfaced in the report (file:line:pattern). */
+export interface ReportOccurrenceDetail {
+    file: string;
+    line: number;
+    pattern: string;
+}
+/** Per-artifact serialized entry. `narrowed` is the report's word for `partial`. */
+export interface ReportArtifact {
+    /** Portable type of the artifact (agent | command | skill | config | rules | hooks). */
+    type: string;
+    /** Source-relative identifier of the artifact. */
+    sourcePath: string;
+    /** Target-relative path written, when it was migrated. */
+    targetPath?: string;
+    /** Outcome, in report vocabulary. */
+    status: "migrated" | "skipped" | "failed" | "narrowed";
+    /** Coarse machine reason grouping (from the decision record). */
+    reason?: string;
+    /** File/line/pattern detail for the first preserved/failed occurrence. */
+    detail?: ReportOccurrenceDetail;
+}
+/** Aggregate outcome counts for the run header. */
+export interface ReportCounts {
+    migrated: number;
+    skipped: number;
+    failed: number;
+    narrowed: number;
+    /** Total distinct artifacts recorded — the identity-check denominator. */
+    total: number;
+}
+/** Budget projection carried into the report (mirrors the preflight budget lines). */
+export interface ReportBudget {
+    lines: string[];
+}
+/** Serialized run header. `timestamp` is a real ISO run time, not any plan id. */
+export interface MigrationReportHeader {
+    provider: ProviderType;
+    /** Toolkit version that produced the run (opaque string; may be "unknown"). */
+    version: string;
+    /** Minimum Codex CLI version whose hook surface this migration targets. */
+    codexMinSupportedVersion?: string;
+    timestamp: string;
+    counts: ReportCounts;
+    budget: ReportBudget;
+    /** Aggregate count of secret-like env key names omitted from the run (never names). */
+    secretKeysOmitted?: number;
+}
+/** The full serialized report (JSON shape). */
+export interface MigrationReport {
+    schemaVersion: typeof MIGRATION_REPORT_SCHEMA_VERSION;
+    header: MigrationReportHeader;
+    artifacts: ReportArtifact[];
+}
+/**
+ * Deterministic stable key for a decision record. Artifact ordering in both the
+ * JSON and md is derived from this key so two runs over unchanged input produce
+ * byte-identical artifact sections (the header timestamp is the only varying part).
+ */
+export declare function artifactKey(record: Pick<MigrationDecisionRecord, "type" | "source" | "provider">): string;
+export declare function foldArtifacts(records: MigrationDecisionRecord[]): ReportArtifact[];
+export interface BuildReportInput {
+    provider: ProviderType;
+    version: string;
+    records: MigrationDecisionRecord[];
+    budgetLines?: string[];
+    secretKeysOmitted?: number;
+    codexMinSupportedVersion?: string;
+    /** Injectable clock for deterministic tests; defaults to the real run time. */
+    now?: () => Date;
+}
+/** Build the serialized report object from a decision-record ledger. */
+export declare function buildMigrationReport(input: BuildReportInput): MigrationReport;
+/** Render the human-readable md report from the same serialized object. */
+export declare function renderMigrationReportMarkdown(report: MigrationReport): string;
+/** The single verdict line printed at the end of a run. */
+export declare function migrationVerdictLine(report: MigrationReport, reportPath: string): string;
+export interface WriteMigrationReportResult {
+    report: MigrationReport;
+    jsonPath: string;
+    mdPath: string;
+    verdictLine: string;
+}
+/**
+ * Serialize the report to `<outputDir>/migration-report.json` and render the md
+ * sibling. Creates the output dir first (never depends on another phase making
+ * it). The caller is responsible for wrapping this in the run's finally-path and
+ * re-throwing any original exception; this function only throws its OWN write
+ * errors, which the caller logs without masking the real failure.
+ */
+export declare function writeMigrationReport(report: MigrationReport, outputDir: string): Promise<WriteMigrationReportResult>;
+//# sourceMappingURL=migration-report-writer.d.ts.map

package/dist/migrate/validation/migration-report-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-report-writer.d.ts","sourceRoot":"","sources":["../../../src/migrate/validation/migration-report-writer.ts"],"names":[],"mappings":"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"}

package/dist/migrate/validation/migration-report-writer.js.map

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

package/dist/migrate/validation/unresolved-reference-scanner.d.ts

@@ -0,0 +1,18 @@
+import type { ReferenceOccurrence } from "../references/reference-types.js";
+export interface ScannedOutput {
+    /** Display name for the output (e.g. "codex/config/CLAUDE" or a file path) */
+    file: string;
+    content: string;
+    occurrences: ReferenceOccurrence[];
+}
+export interface ValidationFinding {
+    severity: "error" | "warning";
+    file: string;
+    line: number;
+    reference: string;
+    message: string;
+}
+/** True when a surviving source reference is covered by a classifier decision. */
+export declare function isExplainedReference(reference: string, occurrences: ReferenceOccurrence[]): boolean;
+export declare function scanUnresolvedReferences(outputs: ScannedOutput[]): ValidationFinding[];
+//# sourceMappingURL=unresolved-reference-scanner.d.ts.map

package/dist/migrate/validation/unresolved-reference-scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unresolved-reference-scanner.d.ts","sourceRoot":"","sources":["../../../src/migrate/validation/unresolved-reference-scanner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC7B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IACjC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB;AAUD,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE,GAAG,OAAO,CASnG;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,iBAAiB,EAAE,CAoBtF"}

package/dist/migrate/validation/unresolved-reference-scanner.js

@@ -0,0 +1,47 @@
+// Post-conversion invariant check: every source reference surviving in
+// generated output must be explained by a classifier decision (preserve,
+// preserve-warn, or a rewrite whose target legitimately still matches the
+// source pattern). An unexplained survivor means the rewriter missed a case —
+// that is an internal error, not a user-content warning.
+import { sourceReferencePattern } from "../references/reference-target-registry.js";
+function lineNumberAt(content, offset) {
+    let line = 1;
+    for (let i = 0; i < offset && i < content.length; i++) {
+        if (content[i] === "\n")
+            line++;
+    }
+    return line;
+}
+/** True when a surviving source reference is covered by a classifier decision. */
+export function isExplainedReference(reference, occurrences) {
+    return occurrences.some((occurrence) => {
+        if (occurrence.decision === "preserve" || occurrence.decision === "preserve-warn") {
+            return occurrence.original.toLowerCase() === reference.toLowerCase();
+        }
+        // A rewrite target can itself match the source pattern (e.g. a provider
+        // that reads skills from the source tree) — that survivor is legitimate.
+        return occurrence.rewrittenTo?.toLowerCase().includes(reference.toLowerCase()) ?? false;
+    });
+}
+export function scanUnresolvedReferences(outputs) {
+    const findings = [];
+    for (const output of outputs) {
+        const pattern = sourceReferencePattern();
+        for (const match of output.content.matchAll(pattern)) {
+            if (match.index === undefined)
+                continue;
+            const reference = match[0];
+            if (isExplainedReference(reference, output.occurrences))
+                continue;
+            findings.push({
+                severity: "error",
+                file: output.file,
+                line: lineNumberAt(output.content, match.index),
+                reference,
+                message: `unexplained source reference "${reference}" survived conversion — the reference rewriter missed this case`,
+            });
+        }
+    }
+    return findings;
+}
+//# sourceMappingURL=unresolved-reference-scanner.js.map

package/dist/migrate/validation/unresolved-reference-scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unresolved-reference-scanner.js","sourceRoot":"","sources":["../../../src/migrate/validation/unresolved-reference-scanner.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,8EAA8E;AAC9E,yDAAyD;AAEzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAC;AAkBpF,SAAS,YAAY,CAAC,OAAe,EAAE,MAAc;IACpD,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvD,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,SAAiB,EAAE,WAAkC;IACzF,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;QACtC,IAAI,UAAU,CAAC,QAAQ,KAAK,UAAU,IAAI,UAAU,CAAC,QAAQ,KAAK,eAAe,EAAE,CAAC;YACnF,OAAO,UAAU,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,CAAC;QACtE,CAAC;QACD,wEAAwE;QACxE,yEAAyE;QACzE,OAAO,UAAU,CAAC,WAAW,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;IACzF,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAwB;IAChE,MAAM,QAAQ,GAAwB,EAAE,CAAC;IAEzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACtD,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;gBAAE,SAAS;YACxC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YAC3B,IAAI,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,WAAW,CAAC;gBAAE,SAAS;YAClE,QAAQ,CAAC,IAAI,CAAC;gBACb,QAAQ,EAAE,OAAO;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC/C,SAAS;gBACT,OAAO,EAAE,iCAAiC,SAAS,iEAAiE;aACpH,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,QAAQ,CAAC;AACjB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mewkit",
-  "version": "1.13.0",
+  "version": "1.14.1",
   "description": "MeowKit CLI — scaffold, upgrade, and manage your AI agent toolkit",
   "type": "module",
   "bin": {

package/portable-manifest.json

@@ -1,7 +1,15 @@
 {
 	"version": "1.0",
-	"mewkitVersion": "1.10.0",
+	"mewkitVersion": "1.14.0",
 	"renames": [],
-	"providerPathMigrations": [],
+	"providerPathMigrations": [
+		{
+			"provider": "codex",
+			"type": "rules",
+			"from": ".codex/rules",
+			"to": "AGENTS.md",
+			"since": "1.14.0"
+		}
+	],
 	"sectionRenames": []
 }