@c4a/context 0.7.14 → 0.7.15

package/docs/guides/knowledge-updates.md

@@ -319,6 +319,12 @@ input without that flag to continue. A preview is not approval and does not make
 a stale revision valid.
 
 Review can approve checked pages while leaving repair pages pending. The HTML
+report shows the current site navigation, candidate changes and expected file
+paths. Unchanged approved pages retain their titles with omitted bodies. Enter
+revision instructions directly in the report; the copied code and following
+instruction lines must be returned together without edits. The CLI binds them to
+the reviewed content and baseline and returns repair commands while leaving
+those pages pending. Changed candidates require a fresh review. The HTML
 review code includes pending positions; managed Review provides the same current
 scope as a JSON template. Send decisions only for pages actually reviewed. Omit
 means a durable exclusion, not repair. Partial approval alone does not build.

package/docs/guides/lark-resources.md

@@ -124,3 +124,41 @@ fixed. Accepted failures remain visible as warnings and unavailable-resource
 notices; they are never represented as downloaded evidence. Review shows
 available previews, references, and warnings so the human or managed policy can
 assess the page with its non-text evidence.
+
+## Image choices for a production task
+
+The work-start report asks once when a task contains more than 30 distinct images
+and has no explicit image policy. The choices are intelligent conversion and
+inclusion (recommended), include all as images with compression, or include none
+with placeholders. Count the whole task, not each capture or writing batch.
+Review reports show the resulting image handling and any fallbacks.
+
+To skip image acquisition while preserving visible source placeholders:
+
+```ts
+captureLark({ source: handbook, resources: { images: "reference-only" } });
+```
+
+To retain static images but exclude GIF files:
+
+```ts
+captureLark({ source: handbook, resources: { gifs: "reference-only" } });
+```
+
+Both fields also accept `bundle`; omitted fields retain normal capture behavior.
+Known GIF metadata avoids downloading; when a source only supplies an opaque
+media token, identification may require downloading the file. Such a GIF is then
+excluded from the snapshot assets and knowledge, rather than decoded or retained.
+Existing evidence is not deleted by changing a policy. Already approved image
+references must be revised through the normal Review flow to change their content.
+
+Inclusion does not mean lossless original-byte delivery. The package optimizer
+preserves animations without decoding every frame or silently flattening them.
+Codec failures and images that cannot fit delivery budgets become visible output
+placeholders with a build warning; approved source bytes remain unchanged.
+Do not rewrite approved prose to repair a codec error or disable pixel safety
+limits. The reading meaning of an image is handled in writing and Review.
+
+Source document links can be retained for viewing under the reader's permissions.
+Temporary signed media links are not durable image hosting. Do not embed access
+tokens in generated pages or claim that excluded images have been interpreted.

package/index.js

@@ -31425,6 +31425,12 @@ var captureFile = (definition) => {
 var captureLark = (definition) => {
   const sourceDefinition = bindSourceType(definition.source, "lark", "captureLark source");
   const sourceId = getSourceName(sourceDefinition);
+  for (const key of ["images", "gifs"]) {
+    const value = definition.resources?.[key];
+    if (value !== undefined && value !== "bundle" && value !== "reference-only") {
+      throw new TypeError(`captureLark resources.${key} must be bundle or reference-only`);
+    }
+  }
   const maxBytesPerResource = definition.resources?.maxBytesPerResource ?? 20 * 1024 * 1024;
   const maxTotalBytes = definition.resources?.maxTotalBytes ?? 200 * 1024 * 1024;
   if (!Number.isSafeInteger(maxBytesPerResource) || maxBytesPerResource < 1) {
@@ -31443,6 +31449,8 @@ var captureLark = (definition) => {
     writes: [sourceSnapshotResource(sourceDefinition, "lark")],
     source: sourceDefinition,
     resources: {
+      ...definition.resources?.images === undefined ? {} : { images: definition.resources.images },
+      ...definition.resources?.gifs === undefined ? {} : { gifs: definition.resources.gifs },
       videos: definition.resources?.videos ?? "reference-only",
       maxBytesPerResource,
       maxTotalBytes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "type": "module",
   "description": "Declarative SDK for Context knowledge sources, workflows, review, and package outputs",
   "license": "MIT",

package/phases.d.ts

@@ -50,6 +50,8 @@ export type CaptureLarkPhaseDefinition = {
     writes: readonly PhaseResourceReference[];
     source: LarkSourceDefinition | LarkSourceReference;
     resources: {
+        images?: "reference-only" | "bundle";
+        gifs?: "reference-only" | "bundle";
         videos: "reference-only" | "bundle";
         maxBytesPerResource: number;
         maxTotalBytes: number;
@@ -76,6 +78,8 @@ export declare const captureFile: (definition: {
 export declare const captureLark: (definition: {
     source: LarkSourceDefinition | LarkSourceReference;
     resources?: {
+        images?: "reference-only" | "bundle";
+        gifs?: "reference-only" | "bundle";
         videos?: "reference-only" | "bundle";
         maxBytesPerResource?: number;
         maxTotalBytes?: number;