@thanh01.pmt/curriculum-kit 1.0.6 → 1.0.8

package/dist/media/index.d.cts

@@ -116,6 +116,8 @@ interface MediaLedgerEntry {
     status: MediaLedgerStatus;
     /** Provider đã dùng (set khi done) */
     provider?: string;
+    /** Inline Markdown credit (tác giả + nguồn + license) — từ multimedia-kit AttributionBuilder */
+    attribution?: string;
     /** Path tương đối trong project sau khi done: _media/xxx.png */
     relPath?: string;
     /** Prompt cuối (đã enrich) — audit/debug */
@@ -144,6 +146,14 @@ declare class MediaLedger {
     setStatus(slug: string, status: MediaLedgerStatus, patch?: Partial<MediaLedgerEntry>): MediaLedgerEntry | undefined;
     /** Đếm ảnh đã done trong lesson — để Curator tôn trọng maxImages */
     doneCount(): number;
+    /**
+     * Scan artifact content và seed pending entries cho mọi placeholder [IMAGE: slug].
+     * Được gọi sau khi agent sinh artifact (trước khi Curator duyệt) — đây là cầu nối
+     * duy nhất giữa "agent chèn placeholder" và "sổ cái có entry để Curator/Fulfiller xử".
+     * Idempotent: slug đã có entry active (pending/approved/done) → giữ nguyên;
+     * chỉ re-describe khi entry trước bị rejected/failed.
+     */
+    seedFromArtifact(artifactId: string, content: string): MediaLedgerEntry[];
 }
 
 type MediaPolicyMode = 'search_only' | 'gen_only' | 'auto';

package/dist/media/index.d.ts

@@ -116,6 +116,8 @@ interface MediaLedgerEntry {
     status: MediaLedgerStatus;
     /** Provider đã dùng (set khi done) */
     provider?: string;
+    /** Inline Markdown credit (tác giả + nguồn + license) — từ multimedia-kit AttributionBuilder */
+    attribution?: string;
     /** Path tương đối trong project sau khi done: _media/xxx.png */
     relPath?: string;
     /** Prompt cuối (đã enrich) — audit/debug */
@@ -144,6 +146,14 @@ declare class MediaLedger {
     setStatus(slug: string, status: MediaLedgerStatus, patch?: Partial<MediaLedgerEntry>): MediaLedgerEntry | undefined;
     /** Đếm ảnh đã done trong lesson — để Curator tôn trọng maxImages */
     doneCount(): number;
+    /**
+     * Scan artifact content và seed pending entries cho mọi placeholder [IMAGE: slug].
+     * Được gọi sau khi agent sinh artifact (trước khi Curator duyệt) — đây là cầu nối
+     * duy nhất giữa "agent chèn placeholder" và "sổ cái có entry để Curator/Fulfiller xử".
+     * Idempotent: slug đã có entry active (pending/approved/done) → giữ nguyên;
+     * chỉ re-describe khi entry trước bị rejected/failed.
+     */
+    seedFromArtifact(artifactId: string, content: string): MediaLedgerEntry[];
 }
 
 type MediaPolicyMode = 'search_only' | 'gen_only' | 'auto';

package/dist/media/index.mjs

@@ -228,6 +228,36 @@ var MediaLedger = class {
   doneCount() {
     return this.listByStatus("done").length;
   }
+  /**
+   * Scan artifact content và seed pending entries cho mọi placeholder [IMAGE: slug].
+   * Được gọi sau khi agent sinh artifact (trước khi Curator duyệt) — đây là cầu nối
+   * duy nhất giữa "agent chèn placeholder" và "sổ cái có entry để Curator/Fulfiller xử".
+   * Idempotent: slug đã có entry active (pending/approved/done) → giữ nguyên;
+   * chỉ re-describe khi entry trước bị rejected/failed.
+   */
+  seedFromArtifact(artifactId, content) {
+    const seeded = [];
+    const re = /\[IMAGE\s*:\s*([a-z0-9][a-z0-9-]*)\s*\]/gi;
+    const seen = /* @__PURE__ */ new Set();
+    let m;
+    while ((m = re.exec(content)) !== null) {
+      const slug = m[1].toLowerCase();
+      if (seen.has(slug)) continue;
+      seen.add(slug);
+      const existing = this.entries.get(slug);
+      const isActive = existing && (existing.status === "pending" || existing.status === "approved" || existing.status === "done");
+      if (isActive) continue;
+      seeded.push(this.upsert({
+        slug,
+        artifactId,
+        name: slug.replace(/^(img-|image-)/, "").replace(/-/g, " "),
+        description: `Placeholder ch\xE8n b\u1EDFi agent trong artifact ${artifactId} \u2014 ch\u1EDD Curator enrich (m\xF4 t\u1EA3 g\u1ED1c ch\u01B0a c\xF3).`,
+        mode: "generate",
+        status: "pending"
+      }));
+    }
+    return seeded;
+  }
 };
 
 // src/errors/index.ts