@c4a/context-cli 0.7.5 → 0.7.9

package/indexers/bundles/context-code-indexer/templates/component-library-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "component-library-maintenance-guide",
+  "profile": "component-library",
+  "reader_goal": "modify-or-diagnose-module",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "modify-or-diagnose-module",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain responsibility, registration, state, persistence and downstream handoffs, actual success and error handling, and change entrypoints. Include only implementation details useful to this maintenance task.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/component-library-public-api-reference.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "component-library-public-api-reference",
+  "profile": "component-library",
+  "reader_goal": "look-up-public-contract",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "look-up-public-contract",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain the declared operation or type, invocation prerequisites, input and output semantics, and a supported example. Share this contract reference with related task pages.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/component-library-usage-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "component-library-usage-guide",
+  "profile": "component-library",
+  "reader_goal": "integrate-capability",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "integrate-capability",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain actual import and setup, when to choose the capability, a minimal example, important combinations and usage limitations.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/component-library.md

@@ -34,9 +34,10 @@ When the Authorized Workset View supplies a public declaration together with
 structured props, events, defaults, variants, maintained examples, or source
 roles, the corresponding reader section must consume those facts or record an
 explicit supported omission/material-gap disposition. Do not replace available
-contract facts with a generic statement about the component directory. A group
-without any reader-authorizing public declaration remains catalog-only and does
-not produce an empty component page.
+contract facts with a generic statement about the component directory. A component group
+without a reader-authorizing public declaration remains catalog-only and does
+not produce an empty component page. Library and system subjects may instead be
+authorized by package entries, maintained documentation or public token sources.
 
 ## Questions the knowledge must answer
 
@@ -60,6 +61,21 @@ not produce an empty component page.
 - **Migration or compatibility guide**: only when maintained sources describe
   version transitions or supported platform constraints.
 
+## Optional guidance for deprecated components
+
+Use this guidance only for deprecated APIs retained in the agreed scope. Reuse
+public-contract templates; deprecated status does not require a separate page.
+Explain why an existing user needs this content, cite the deprecation notice,
+and identify the exact supported import or legacy entrypoint. Let the generated
+API table carry props and defaults; prose covers component-specific constraints.
+
+Include styling passthrough, accessibility or migration advice only when relevant
+and supported by sources. Omit inapplicable sections. Do not infer a replacement,
+removal date or migration guarantee from a deprecated label. If migration is the
+reader's goal but supporting guidance is missing, state that gap. Shared migration
+background can live in one existing guide, with individual pages explaining their
+differences and linking to it; do not create a generic guide just to fill a template.
+
 ## Chapter blueprints
 
 ```markdown
@@ -105,3 +121,24 @@ to disguise an enumeration-heavy index.
 - examples invent combinations that maintained usage does not support;
 - accessibility or provider requirements are asserted without evidence;
 - one-page-per-component expansion has no consumer-navigation justification.
+
+
+## Library and design-system subjects
+
+Use a library subject for a module's installation, package entries, shared
+providers, platform support and navigation (L05); it does not require inventing a
+component export. Keep individual public components or families in component
+subjects (L02). A design-system subject is appropriate when authorized token,
+theme, stylesheet or maintained specification material establishes a stable
+system boundary (L03), including a token-only package without React exports.
+Do not infer a whole design system from ordinary component styling.
+
+Owned members stay with one primary subject. Link shared configuration and
+approved component articles instead of copying their bodies. Where no independent
+library material exists, incorporate the useful entry into the parent map. Missing
+public declarations prevent invented component contracts, not a source-backed
+library or token entry. Preserve methods, refs, composition and nested types when
+available; use declared code facts for deterministic API values and explain usage
+with separately cited prose. Examples must come from read sources and retain
+platform/version applicability. Ordinary version differences and suggested
+chapters are advisory; assess compatibility as an Agent and preserve uncertainty.

package/indexers/bundles/context-code-indexer/templates/contract-source-public-api-reference.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "contract-source-public-api-reference",
+  "profile": "contract-source",
+  "reader_goal": "look-up-public-contract",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "look-up-public-contract",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain the declared operation or type, invocation prerequisites, input and output semantics, and a supported example. Share this contract reference with related task pages.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/contract-source-usage-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "contract-source-usage-guide",
+  "profile": "contract-source",
+  "reader_goal": "integrate-capability",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "integrate-capability",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain actual import and setup, when to choose the capability, a minimal example, important combinations and usage limitations.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/contract-source.md

@@ -71,3 +71,52 @@ must contain exact contract identities and source locators, not just filenames.
 
 Revise or stop when authority cannot be distinguished from a generated copy,
 imports or versions are unresolved, or compatibility claims are not declared.
+
+## Overview maps for a selected contract family
+
+When the user chooses a bounded overview, organize the page as scope/version,
+contract-family map, representative operations, active consumers, lookup procedure,
+change/generation entrypoints and unread boundaries. Separate API entry schemas,
+domain contracts, runtime RPC/message boundaries and common models when the source
+actually distinguishes them. Do not force these layers onto an unrelated schema.
+
+A useful family row contains purpose, authoritative directory/file, known consumer
+and the next lookup. A representative operation row can connect reader action,
+external operation identity, schema Service/Method and implementation locator;
+mark an unknown hop as a question, never a proven call. Count only with a recorded
+file-set boundary or reproducible inventory; a few examples cannot establish
+complete coverage or a total operation count. Cross-file imports needed to explain
+a selected type are supporting evidence, not automatic new article subjects.
+
+For large groups, directory routes with scoped searches are preferable to thousands
+of file rows. Give an actual lookup example and what to do when no match is found.
+A short article does not imply cheap extraction: the confirmed overview treatment
+must first be expressible in the actual source/production configuration. This
+writing template does not change parser depth. If the current contract profile
+would still prepare the entire source, resolve that scope before proceeding;
+do not silently select another profile or claim deferred parsing already happened.
+
+## Prefer linked definitions over schema transcription
+
+For entry-first knowledge, avoid exhaustive IDL reading and rewriting. Start with
+consumer/generator configuration and known operation identities; inspect only the
+definitions needed for the actual claim. A file locator does not prove its fields
+or runtime use. Keep complete schema bodies out of Markdown unless a short excerpt
+is necessary to explain the reader's question. Do not modify authoritative IDL.
+
+A source-backed attachment is useful only when an article explicitly needs and
+links that exact definition. Repository presence alone never selects an asset.
+If a supported source-resource projection exists, use its registered source,
+revision, relative path and byte digest; never copy the entire IDL tree or hand-write
+knowledge/assets. Otherwise retain a versioned source locator and state that the
+offline attachment is unavailable. The existing document-attachment mechanism is
+not proof that repository files have been registered as source assets.
+
+An attached IDL remains source evidence, not a second authoritative contract or
+an instruction to create another article. Include dependencies are added only
+when needed for the documented use; distinguish a readable excerpt from a complete,
+compilable schema bundle. Do not claim the attachment compiles unless verified.
+Source byte changes must invalidate the affected resource and dependent evidence;
+unchanged bytes can reuse the resource. A repository revision change alone does
+not prove a changed definition, and source bytes changing do not prove a breaking
+API change. Preserve source identity even when identical bytes share storage.

package/indexers/bundles/context-code-indexer/templates/data-sync-reconciliation-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "data-sync-reconciliation-maintenance-guide",
+  "profile": "data-sync-reconciliation",
+  "reader_goal": "modify-or-diagnose-module",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "modify-or-diagnose-module",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain responsibility, registration, state, persistence and downstream handoffs, actual success and error handling, and change entrypoints. Include only implementation details useful to this maintenance task.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->

package/indexers/bundles/context-code-indexer/templates/data-sync-reconciliation-task-runtime-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "data-sync-reconciliation-task-runtime-guide",
+  "profile": "data-sync-reconciliation",
+  "reader_goal": "operate-or-extend-task",
+  "applicability": {
+    "artifact_policy_variants": [
+      "standard",
+      "compact",
+      "expanded"
+    ],
+    "condition_refs": []
+  },
+  "variables": [
+    {
+      "id": "api",
+      "type": "json",
+      "content_layer": "deterministic-fact",
+      "required": false,
+      "evidence_required": true
+    }
+  ],
+  "deterministic_blocks": [
+    {
+      "id": "api-table",
+      "renderer": "public-contract-table",
+      "source_variable_id": "api"
+    }
+  ],
+  "sections": [
+    {
+      "section_key": "api",
+      "presence": "optional",
+      "question_ref": "question:public-contract",
+      "reader_goal": "operate-or-extend-task",
+      "variable_ids": [
+        "api"
+      ],
+      "deterministic_block_ids": [
+        "api-table"
+      ],
+      "accepted_evidence_kinds": [
+        "code",
+        "contract",
+        "configuration",
+        "documentation"
+      ],
+      "minimum_evidence_items": 0,
+      "on_missing": "omit",
+      "deletion_condition": "Omit when no authorized structured contract is available."
+    }
+  ],
+  "page_policy": {
+    "split_suggestion": "Explain trigger and registration, input routing, effects and actual success conditions, then only source-supported retry, idempotency, compensation and operational guidance. Function success is not automatically business completion.",
+    "semantic_boundaries": [
+      "reader-task",
+      "public-contract"
+    ],
+    "keep_single_page_conditions": [
+      "one-reader-subject"
+    ]
+  },
+  "anonymous_section_examples": [
+    "A source-backed explanation of when to use an operation and how its options interact, referring to the generated API table without repeating its rows."
+  ],
+  "anti_examples": [
+    "Inferring server behavior from a generated client.",
+    "Duplicating a program-generated API table in prose or using prose to contradict its field values."
+  ],
+  "forbidden_outputs": [
+    "Unresolved internal identifiers in reader-facing tables."
+  ],
+  "maximum_rendered_bytes": 1048576
+}
+---
+<!-- context:indexer-section api -->
+## API
+
+{{block:api-table}}
+<!-- /context:indexer-section -->