@c4a/context-cli 0.7.14 → 0.7.15

package/indexers/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "protocol": "context.indexer.cli-release-manifest/v1",
   "package": "@c4a/context-cli",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "issuer": "context4ai/context",
   "bundles": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "type": "module",
   "description": "Local runtime and Agent integration for traceable knowledge production",
   "license": "MIT",
@@ -24,17 +24,17 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.3.0",
-    "@c4a/context": "0.7.14",
-    "@c4a/extract": "0.7.14",
-    "@c4a/extract-contract": "0.7.14",
-    "@c4a/extract-go": "0.7.14",
-    "@c4a/extract-mdx": "0.7.14",
-    "@c4a/extract-proto": "0.7.14",
-    "@c4a/extract-rush": "0.7.14",
-    "@c4a/extract-sql": "0.7.14",
-    "@c4a/extract-style": "0.7.14",
-    "@c4a/extract-thrift": "0.7.14",
-    "@c4a/extract-ts": "0.7.14",
+    "@c4a/context": "0.7.15",
+    "@c4a/extract": "0.7.15",
+    "@c4a/extract-contract": "0.7.15",
+    "@c4a/extract-go": "0.7.15",
+    "@c4a/extract-mdx": "0.7.15",
+    "@c4a/extract-proto": "0.7.15",
+    "@c4a/extract-rush": "0.7.15",
+    "@c4a/extract-sql": "0.7.15",
+    "@c4a/extract-style": "0.7.15",
+    "@c4a/extract-thrift": "0.7.15",
+    "@c4a/extract-ts": "0.7.15",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",
     "handlebars": "^4.7.8",

package/parserEntryWorker.js

@@ -19955,6 +19955,12 @@ var getSourceType = (sourceDefinition) => {
 }), 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) {
@@ -19973,6 +19979,8 @@ var getSourceType = (sourceDefinition) => {
     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/plugins/VERSION

@@ -1 +1 @@
-0.7.14
+0.7.15

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "author": {
     "name": "c4a"
   },

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": { "name": "c4a" },
   "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.14",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.15",
     "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
     "developerName": "c4a",
     "category": "Productivity",

package/plugins/cursor/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "displayName": "C4A Context",
-  "version": "0.7.14",
+  "version": "0.7.15",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "Context4AI",

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.7.14"
+    "version": "0.7.15"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -183,7 +183,7 @@
     {
       "id": "context.sdk.lark-resources",
       "path": "resources/manuals/guides/lark-resources.md",
-      "digest": "sha256:3a80574fd70c160b362cee23ab01cbdc3ec366b503daa11aaaf242b7cf5dbe50"
+      "digest": "sha256:b1ffb74a145962ff89a5db29cffd1318e4ec038b97884dcd43804170cb0f6f64"
     },
     {
       "id": "context.sdk.package-outputs",
@@ -258,7 +258,7 @@
     {
       "id": "dialogue.knowledge-review",
       "path": "resources/dialogue/knowledge-review.md",
-      "digest": "sha256:2938843d7c07f03ea70144cd4f1800dedf2fca35610b815800c78c0ad6c2d723"
+      "digest": "sha256:d61cd56bc74ea0653ac6d02588115575ca7d7c21b4ac071d3868c4a2524242b6"
     },
     {
       "id": "dialogue.package-output",
@@ -288,7 +288,7 @@
     {
       "id": "procedure.document-capture",
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:f09100425c2b89a126c35c4490b0644519a4eee214114f2f0f52b6ea20467a04"
+      "digest": "sha256:9d0d1b9187bbe540a4afffb366cd549385dbf61bfaffa96ae51de848b2dd5460"
     },
     {
       "id": "procedure.homogeneous-source-review",
@@ -303,12 +303,12 @@
     {
       "id": "procedure.knowledge-review",
       "path": "resources/procedures/knowledge-review.md",
-      "digest": "sha256:56185e8ea580015e89429a18faf3c7598f8200dc3ee458dbee04d6cbffadcb58"
+      "digest": "sha256:69dc39212547ea8a304c20d6fadc2bd3eb1de83eaf0c62dade8fcf5e8695c5d6"
     },
     {
       "id": "procedure.knowledge-updates",
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:6132bad75635e1ef388c5bf7dd6cd0d3d1fc521a16b44c3bc4d934a7467e516e"
+      "digest": "sha256:e3bf78d43ebc4263bc5d4c08984e51af6d4df16bd2d5d708622816442b777949"
     },
     {
       "id": "procedure.note",
@@ -328,7 +328,7 @@
     {
       "id": "procedure.production-requirements",
       "path": "resources/procedures/production-requirements.md",
-      "digest": "sha256:be0eda60679808dfe4f8fbe30639ad6f24590d8e7f2b588c233a4f611c045c92"
+      "digest": "sha256:a01bcdf788d9c8fd1cc6ba4ba47f19da6df99cd2397ed35eaaa3d3fdc8b6ec25"
     },
     {
       "id": "procedure.production-stage-files",
@@ -348,7 +348,7 @@
     {
       "id": "procedure.runtime-event-delivery",
       "path": "resources/procedures/runtime-event-delivery.md",
-      "digest": "sha256:bb7e695270d9d8780fa7b7cdd4cde883cc05a5f63e97fb18088838623f4ce381"
+      "digest": "sha256:06cf0f47ce2d88915645dcf17012159141ce0a02d427cb7784130345928c0700"
     },
     {
       "id": "procedure.sessions",
@@ -383,7 +383,7 @@
     {
       "id": "procedure.work-start-report",
       "path": "resources/procedures/work-start-report.md",
-      "digest": "sha256:7e27909f3e0209ff88c98a87db8cab3bbf84a915ae2abb5c2453b7525315e45e"
+      "digest": "sha256:dd9de0f63a5de562f84ac1e860e8802934d5a6302e92a666028cd72e0cf18e48"
     },
     {
       "id": "procedure.workspace-commit",
@@ -570,7 +570,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:d7932685876d1ce6ae7d06442f8d59249de936893d22cf46fcca25a8949ba18f"
+      "digest": "sha256:a2518b2b208567cf4ef63ab83d7c087de2f9ace2043e0e2b07f2218337d353f3"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -602,7 +602,7 @@
     },
     {
       "path": "resources/dialogue/knowledge-review.md",
-      "digest": "sha256:2938843d7c07f03ea70144cd4f1800dedf2fca35610b815800c78c0ad6c2d723"
+      "digest": "sha256:d61cd56bc74ea0653ac6d02588115575ca7d7c21b4ac071d3868c4a2524242b6"
     },
     {
       "path": "resources/dialogue/package-output.md",
@@ -626,11 +626,11 @@
     },
     {
       "path": "resources/manuals/guides/knowledge-updates.md",
-      "digest": "sha256:263410c1a4c34ae843297552b6575fa23a780c4095c694e03cc64e9cb292325c"
+      "digest": "sha256:3fa4b18e1919578e8939fffba40d250e8898ed6e85376fd2758abe3d12b908d8"
     },
     {
       "path": "resources/manuals/guides/lark-resources.md",
-      "digest": "sha256:3a80574fd70c160b362cee23ab01cbdc3ec366b503daa11aaaf242b7cf5dbe50"
+      "digest": "sha256:b1ffb74a145962ff89a5db29cffd1318e4ec038b97884dcd43804170cb0f6f64"
     },
     {
       "path": "resources/manuals/guides/markdown-indexer-skill-authoring.md",
@@ -690,7 +690,7 @@
     },
     {
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:f09100425c2b89a126c35c4490b0644519a4eee214114f2f0f52b6ea20467a04"
+      "digest": "sha256:9d0d1b9187bbe540a4afffb366cd549385dbf61bfaffa96ae51de848b2dd5460"
     },
     {
       "path": "resources/procedures/homogeneous-source-review.md",
@@ -702,11 +702,11 @@
     },
     {
       "path": "resources/procedures/knowledge-review.md",
-      "digest": "sha256:56185e8ea580015e89429a18faf3c7598f8200dc3ee458dbee04d6cbffadcb58"
+      "digest": "sha256:69dc39212547ea8a304c20d6fadc2bd3eb1de83eaf0c62dade8fcf5e8695c5d6"
     },
     {
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:6132bad75635e1ef388c5bf7dd6cd0d3d1fc521a16b44c3bc4d934a7467e516e"
+      "digest": "sha256:e3bf78d43ebc4263bc5d4c08984e51af6d4df16bd2d5d708622816442b777949"
     },
     {
       "path": "resources/procedures/note.md",
@@ -722,7 +722,7 @@
     },
     {
       "path": "resources/procedures/production-requirements.md",
-      "digest": "sha256:be0eda60679808dfe4f8fbe30639ad6f24590d8e7f2b588c233a4f611c045c92"
+      "digest": "sha256:a01bcdf788d9c8fd1cc6ba4ba47f19da6df99cd2397ed35eaaa3d3fdc8b6ec25"
     },
     {
       "path": "resources/procedures/production-stage-files.md",
@@ -738,7 +738,7 @@
     },
     {
       "path": "resources/procedures/runtime-event-delivery.md",
-      "digest": "sha256:bb7e695270d9d8780fa7b7cdd4cde883cc05a5f63e97fb18088838623f4ce381"
+      "digest": "sha256:06cf0f47ce2d88915645dcf17012159141ce0a02d427cb7784130345928c0700"
     },
     {
       "path": "resources/procedures/sessions.md",
@@ -766,7 +766,7 @@
     },
     {
       "path": "resources/procedures/work-start-report.md",
-      "digest": "sha256:7e27909f3e0209ff88c98a87db8cab3bbf84a915ae2abb5c2453b7525315e45e"
+      "digest": "sha256:dd9de0f63a5de562f84ac1e860e8802934d5a6302e92a666028cd72e0cf18e48"
     },
     {
       "path": "resources/procedures/workspace-commit.md",
@@ -869,5 +869,5 @@
     "indexer": [],
     "workspace": []
   },
-  "digest": "sha256:4b30698cc222807e84c58c14e0d5a367786e65d3173aca206ee68ab3b44bd052"
+  "digest": "sha256:40dfe816123dd5ab631d088d2c2337290dbc91516bb968b7be5f31be45282f6b"
 }

package/providers/context/provider.yaml

@@ -1,6 +1,6 @@
 schema: agent-graph.provider.v1
 id: c4a/context
-version: 0.7.14
+version: 0.7.15
 name: Context workflow
 description: Internal work contract for Context knowledge workspaces.
 graphs:

package/providers/context/resources/dialogue/knowledge-review.md

@@ -10,17 +10,18 @@ Explain that Review is the boundary between draft candidates and approved
 Markdown. In ordinary mode:
 
 1. open the complete current Review report;
-2. let the user approve or reject candidates;
+2. let the user approve, reject, or request revisions to candidates;
 3. ask them to copy the review code back into the conversation; and
 4. apply only that exact review code through the returned command.
 
 The user does not need to create a payload file; the Agent may write the pasted
 review code to ignored scratch storage for the CLI command. Preserve it exactly;
-do not decode, regenerate, summarize, or edit it. Each segment is at most 980
-characters. If there are multiple segments, collect all of them and write one
-segment per line in the same input file before applying once. Never apply a
-partial set. If CLI reports missing, mixed, damaged, or stale segments, follow
-its diagnostic; ask for missing segments or a fresh review code as appropriate.
+do not decode, regenerate, summarize, or edit it. The code carries decisions and
+revision instructions together. If it exceeds 1,000 characters, use a direct
+reply (mention the Bot when relevant) instead of a length-limited form. Older
+segmented codes still require every segment in the same input file. If the CLI
+reports damaged or stale feedback, follow its diagnostic and request a fresh
+report/code; never repair a code by hand.
 Never derive a payload
 from HTML, candidate ids, snapshots, or a default decision.
 
@@ -50,3 +51,10 @@ the index's current scope template. Approve only pages actually reviewed; leave
 undecided and repair pages pending. Do not open HTML or persist a parallel review
 ledger. A partial review code in ordinary mode likewise leaves pending pages
 unchanged; all segments of that code are still required.
+
+After applying feedback, follow each returned repair command with the user's
+exact instruction. Repairs remain pending; neither copying nor applying the
+code approves them. Pending instructions are retained by the CLI and exposed in
+the current review resource after a session restart. Re-read and review the
+resulting candidate before approval. Do not silently replace a revision request
+with rejection or bulk approval.

package/providers/context/resources/manuals/guides/knowledge-updates.md

@@ -325,6 +325,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/providers/context/resources/manuals/guides/lark-resources.md

@@ -130,3 +130,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/providers/context/resources/procedures/document-capture.md

@@ -62,3 +62,10 @@ are available while another capture remains pending. Keep unresolved sources in
 `pending_scopes`; do not cite their unavailable snapshots. The Route returns to
 pending capture after the active production/review work, before delivery completes.
 This does not mark failed captures as complete or waive source-read authorization.
+
+For image-heavy tasks, reuse the image choice in the work-start report. When
+source descriptors already show more than 30 distinct images across the task,
+resolve that question before bulk media acquisition. If counts emerge only from
+capture, stop further image processing to confirm the choice during planning.
+Use explicit image/GIF reference-only policies for exclusions; never substitute
+temporary signed media URLs as permanent public image links.

package/providers/context/resources/procedures/knowledge-review.md

@@ -23,7 +23,7 @@ authorization.
 Without explicit session-managed authority:
 
 - open the report returned by the route;
-- let the user publish or durably omit candidates;
+- let the user approve, reject, or request revisions to candidates;
 - apply the exact copied review code through the returned review apply command; and
 - retain the exact report reference and reviewed scope in this conversation for
   the final completion summary.
@@ -58,10 +58,24 @@ Use the explicit retirement preview after replacement delivery, and repair its
 reported incoming references. Navigation removal alone does not remove content
 from search or packages. A renamed menu does not require a new article identity.
 
-The Review UI names the internal `rejected` decision **Omit** because it is a
-durable content decision, not a request to rewrite the page. When a page needs
-changes, leave that page pending and use `context revise` so the owning
-Author or Composer produces a new Candidate through the same lifecycle.
+The report opens on a change overview, with the existing navigation and an
+expected workspace file tree. The CLI collects approved titles, navigation and
+candidate bodies; it renders their changes mechanically. Do not write a second
+summary in place of candidate content or rewrite the HTML. New workspaces show
+all candidate pages as New. Existing unchanged pages show titles only; changed
+blocks and previous text remain available for comparison. Navigation without a
+Git baseline is labelled as current context, not an invented historical diff.
+
+Approve accepts a candidate. Reject durably omits it; it does not request a
+rewrite or retire an approved article. Entering revision instructions requests
+repair and locks the other choices for that page until cancelled. Bulk approval
+requires confirmation and affects only undecided pages. When the report contains
+new top-level categories, the dialog lists them and requires explicit
+acknowledgment plus an eight-second wait before confirmation is enabled.
+New descendant pages under an existing category do not trigger this extra step. The copied code binds
+the candidate scope, exact content, displayed baseline and revision instructions;
+the CLI validates these together before writing any decision. Follow returned
+repair commands, then obtain review of the repaired candidates.
 
 Use the affected page's `Repair` command in the review material, replacing only
 the correction instruction. Current candidates are repaired within this batch;
@@ -132,3 +146,10 @@ only its own titles. When revising or merging, preserve useful existing detail
 instead of replacing it with generic lookup advice. Repair affected pages or
 use the current planning route for missing topics. These are Agent judgments,
 not minimum article counts, a new coverage ledger or an extra CLI approval gate.
+
+For image-heavy work, show the selected task image policy and actual retained,
+converted and placeholder counts from the candidates and capture reports. Explain
+any fallback affecting reader understanding. Reuse the planning choice; do not
+turn image handling into another per-article approval. Missing image content must
+not be presented as read or fully covered. Build-only media fallbacks are reported
+in the build receipt and do not rewrite approved evidence.

package/providers/context/resources/procedures/knowledge-updates.md

@@ -325,6 +325,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/providers/context/resources/procedures/production-requirements.md

@@ -59,3 +59,26 @@ contains `path`, `question`, `sources` and `batch`, with optional `brief` and
 command to prepare those tasks without a separate investigation-plan submission.
 This does not approve the report or permit writing before user feedback.
 When targets are unclear, use normal preparation and investigate the skeletons.
+
+## Configured coverage and the current request
+
+`src/indexers.yaml` describes the workspace's standing coverage configuration.
+Source registration or presence in that configuration does not, by itself, mean
+that the source needs investigation again for this request. For a bounded document
+addition or revision, identify its reader task and actual evidence dependencies;
+reuse existing approved articles and applicable completed work. Do not broaden a
+document task to unrelated code repositories merely because they are configured.
+
+In planning and completion reports distinguish:
+- work requested and completed in this task;
+- specific content gaps established by reading, with their affected reader tasks;
+- source/environment failures, and whether this task depends on those sources.
+
+A `pending_scopes` count is workflow state, not a count of missing topics,
+repositories to rewrite, or articles to produce. A Git spawn/baseline-read error
+means source availability could not be checked; it does not prove that existing
+knowledge is absent or obsolete. If unrelated configured sources remain blocked,
+say so as a workflow limitation rather than announcing new investigation work.
+Do not delete configured sources, invent exclusions, clear stage files, or mark
+unread material investigated to make the current task appear complete. Follow the
+returned resolution action when the workflow still needs a decision.

package/providers/context/resources/procedures/runtime-event-delivery.md

@@ -22,12 +22,18 @@ remove the Agent host's network approval boundary. Satisfy that boundary by
 requesting host network escalation in the tool invocation that executes the
 flush, not by turning it into another conversational approval gate.
 
-Before requesting network access, run:
+When first requesting host network access, or diagnosing an unknown destination, run:
 
 ```bash
 context logs plan --format json
 ```
 
+When delivery is already authorized and the fixed destination and data policy are
+unchanged, execute `context logs flush --format json` directly. A prior plan
+receipt is not a CLI prerequisite. Do not repeatedly plan or ask for consent on
+retries. `invalid_batch` from the command bridge is local protocol rejection before
+HTTP; repair/update the compatible sink client rather than retrying network access.
+
 The plan is the audit contract. It reports the canonical workspace outbox,
 normally `.tmp/context-runtime/logs/outbox.jsonl`, the event count and kinds,
 the allowlisted property names, the sink command, and the resolved HTTP

package/providers/context/resources/procedures/work-start-report.md

@@ -78,6 +78,42 @@ Estimate timing or savings only when supported by measurements and conditions.
 For a small addition to an existing site, describe only the affected reading
 position; reuse its layout and delivery choices instead of proposing them again.
 
+## Confirm image handling for large tasks
+
+Before bulk image interpretation or article writing, count distinct image resources
+across the current authorized task (all its sources, not each document or batch).
+Use source descriptors and capture reports; do not download images just to count
+or recount unchanged snapshots. If the count exceeds 30 and the user has not
+already selected a policy for this task, include one image-handling question in
+this planning confirmation, in the user's language:
+
+- **Process all (default): intelligent conversion and inclusion.** Read images as
+  needed; retain useful images or convert suitable content into text, tables or
+  diagrams. Conversion is an Agent writing decision supported by actual reading.
+- **Include all:** retain the image presentation; automatic compression and safe
+  processing still apply. An image that cannot be processed within limits becomes
+  a visible placeholder, not an unlimited original-byte delivery promise.
+- **Include none (placeholders):** skip image bytes and interpretation; preserve
+  placeholders and source document links. Do not claim image-content coverage.
+
+Default means the recommended option, not consent after silence. Wait for this
+choice together with the existing plan confirmation; never add per-image or
+per-batch approval. Reuse an explicit choice and any GIF exclusions throughout
+retries. Persist the choice in the existing plan/requirements. If discovery only
+reveals the threshold after initial capture, ask before further image work and
+writing; do not restart completed capture solely to show this question.
+
+Report the known count and unknown resources separately. If the scale was unknown
+and later crosses 30, ask once at that point. At content Review summarize retained,
+converted and placeholder outcomes with reasons, including automatic fallbacks;
+do not ask the same policy question again. A later material policy change belongs
+in the existing plan and normal Review, not a separate approval protocol.
+
+Use `captureLark.resources.images: reference-only` for excluded images and
+`resources.gifs: reference-only` for an explicit GIF exclusion. Both inclusion
+choices use normal capture and package optimization; the Agent controls semantic
+conversion. See the Lark resource guide for configuration and limitations.
+
 ## Review navigation changes in context
 
 Read the knowledge-updates guidance on preserving established navigation intent.
@@ -119,3 +155,39 @@ Reports, plans, skills, candidates, confirmation and transaction process stay in
 `.tmp`. Only formal results and necessary long-term source/requirement decisions
 belong in non-temporary storage. On a new machine, start new production from those
 formal inputs, without requiring the previous report or production session.
+
+## Inputs for the content Review report
+
+Keep approved article titles, paths, reading order and intended placements in the
+normal article plan and knowledge map. Complete their existing structure workflow
+before presenting content Review. The CLI collects those inputs and the actual
+candidate bodies to render the report; do not ask an Agent to fabricate a site
+snapshot, infer approved content from titles, or maintain a second report model.
+For a new workspace, plan the initial categories through the same workflow; the
+report will label its candidate pages New. If it shows unplaced articles, finish
+those placements rather than presenting the fallback as an approved new category.
+Content Review displays changes; it does not replace specific authorization for
+a top-level navigation change already required by this procedure.
+
+## Configured coverage and the current request
+
+`src/indexers.yaml` describes the workspace's standing coverage configuration.
+Source registration or presence in that configuration does not, by itself, mean
+that the source needs investigation again for this request. For a bounded document
+addition or revision, identify its reader task and actual evidence dependencies;
+reuse existing approved articles and applicable completed work. Do not broaden a
+document task to unrelated code repositories merely because they are configured.
+
+In planning and completion reports distinguish:
+- work requested and completed in this task;
+- specific content gaps established by reading, with their affected reader tasks;
+- source/environment failures, and whether this task depends on those sources.
+
+A `pending_scopes` count is workflow state, not a count of missing topics,
+repositories to rewrite, or articles to produce. A Git spawn/baseline-read error
+means source availability could not be checked; it does not prove that existing
+knowledge is absent or obsolete. If unrelated configured sources remain blocked,
+say so as a workflow limitation rather than announcing new investigation work.
+Do not delete configured sources, invent exclusions, clear stage files, or mark
+unread material investigated to make the current task appear complete. Follow the
+returned resolution action when the workflow still needs a decision.