@c4a/context-cli 0.6.19 → 0.7.1

package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/monorepo-container.md

@@ -1,5 +1,5 @@
 ---
-id: semantic.code-index.template.monorepo-container
+id: context.code-indexer.template.monorepo-container
 kind: procedure
 media-type: text/markdown
 ---
@@ -11,7 +11,7 @@ registration, ownership, dependency, build, or release topology of multiple
 child modules. Do not treat the physical repository as one application merely
 because it has one Git remote.
 
-Recommended `outputProfile`: `module-registry`.
+Use the exact profile and Artifact policy variant supplied by the workset.
 
 ## Evidence pass
 
@@ -55,12 +55,11 @@ fallback and must not silently include generated output or dependency caches.
 Every user-visible child application, service, library, or CLI is classified as
 its own index unit before deeper extraction.
 
-For `extractTs()`, each child package must first be registered as its own source
-boundary. One root source cannot be assigned to several index units because
-source-level ownership would be ambiguous. If source registration intentionally
-remains at repository level, use `extractCustom()` for the container registry
-and assign aggregate candidates explicitly; do not use `include` to simulate
-package ownership.
+Each independently visible child package must have one canonical inventory
+identity and one primary partition owner. If source registration intentionally
+remains at repository level, keep the container registry as an aggregate
+logical unit and let Context build child worksets from canonical package facts;
+do not use file filters to simulate package ownership.
 
 ## Chapter blueprints
 
@@ -109,9 +108,10 @@ but should not override declared workspace ownership or package boundaries.
 
 - A workspace containing a Web app, API gateway, CLI, and generated client
   produces one registry plus separately classified child units.
-- A workspace with independent release groups selects `build-release`; retain
-  the release map at the container level and package-specific compatibility in
-  each `sdk-library` unit.
+- A workspace with independent release groups reads the
+  `development-and-delivery.md` composer contract; retain the release map at
+  the container level and package-specific compatibility in each `sdk-library`
+  unit.
 - A cross-module request flow reads `cross-module-chain.md` and receives its
   own output owner when it spans several child units.
 

package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/plugin-extension.md

@@ -1,5 +1,5 @@
 ---
-id: semantic.code-index.template.plugin-extension
+id: context.code-indexer.template.plugin-extension
 kind: procedure
 media-type: text/markdown
 ---

package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/sdk-library.md

@@ -1,5 +1,5 @@
 ---
-id: semantic.code-index.template.sdk-library
+id: context.code-indexer.template.sdk-library
 kind: procedure
 media-type: text/markdown
 ---
@@ -11,7 +11,8 @@ SDKs, public framework extensions, or shared runtimes consumed through a
 deliberately supported interface. A package being imported elsewhere is not
 enough; confirm its supported entry and consumer contract.
 
-Recommended `outputProfile`: `public-api-reference`.
+Use the exact sdk-library or component-library profile and Artifact policy
+variant supplied by the workset.
 
 ## Evidence pass
 
@@ -103,11 +104,10 @@ when consumers search for that exact public identity and its contract contains
 meaningful behavior beyond a signature. Do not copy complete function bodies,
 private members, generated declarations, fixtures, or every re-export.
 
-The 300-page limit remains per index unit. When a granular public surface would
-cross it, keep the public identities navigable but aggregate them into
-capability-family pages through `extractCustom()`; the limit is not raised for
-large libraries, and splitting one `extractTs()` source into overlapping units
-is not a valid workaround.
+When a granular public surface would create enumeration-heavy output, keep the
+public identities navigable but aggregate them into capability-family
+Artifacts. Do not split one source into overlapping owners or invent ordinal
+batches to evade the CLI profile contract.
 
 Relate public entries to capability families, configuration, examples, and
 external protocols. Internal call graphs are secondary unless the knowledge
@@ -117,10 +117,10 @@ goal explicitly concerns extension or lifecycle behavior.
 
 - A component library may use granular component pages plus family indexes,
   while its demo site is a separate `web-application` unit.
-- A generated client reads `derived-source.md` and
+- A generated client reads `derived-generated-source.md` and
   `protocol-boundary.md`; document the supported client surface while naming
   the upstream schema authority.
-- A library with a plugin host also reads `adapter.md` and
+- A library with a plugin host also reads `adapter-integration.md` and
   `plugin-extension.md`.
 
 ## Revise or stop when

package/{providers/context/resources/semantic/code-index/templates/persistence-boundary.md → indexers/bundles/context-code-indexer/templates/storage-repository.md}

@@ -1,12 +1,12 @@
 ---
-id: semantic.code-index.template.persistence-boundary
+id: context.code-indexer.template.storage-repository
 kind: procedure
 media-type: text/markdown
 ---
 
-# Persistence boundary template
+# Storage repository template
 
-Use for `persistence` when durable state, cache behavior, consistency, or
+Use for `storage-repository` when durable state, cache behavior, consistency, or
 recovery is part of the confirmed reader goal. This template supplements the
 service or runtime that owns the operations; it is not a request to catalog
 every model or query.

package/{providers/context/resources/semantic/code-index → indexers/bundles/context-code-indexer}/templates/web-application.md

@@ -1,5 +1,5 @@
 ---
-id: semantic.code-index.template.web-application
+id: context.code-indexer.template.web-application
 kind: procedure
 media-type: text/markdown
 ---
@@ -15,7 +15,7 @@ only browser code. It does
 not automatically cover every package containing UI components; a reusable
 component package is usually `sdk-library`.
 
-Recommended `outputProfile`: `application-map`.
+Use the exact profile and Artifact policy variant supplied by the workset.
 
 ## Evidence pass
 
@@ -127,7 +127,7 @@ product intent out of the index.
 
 - A server-rendered application with local API routes also reads
   `api-service.md` and `protocol-boundary.md`.
-- An embedded application with a host bridge also reads `adapter.md` and the
+- An embedded application with a host bridge also reads `adapter-integration.md` and the
   applicable `plugin-extension.md` or `protocol-boundary.md` template.
 - A design-system package rendered in a demo application may need separate
   index units: `sdk-library` for the supported package and `web-application`
@@ -142,4 +142,5 @@ product intent out of the index.
 - one-symbol-per-page selection expands components or API types without a
   deliberate public-reference goal.
 
-Resolve these issues before the measured batch preview.
+Resolve these issues before returning the current author Result for mechanical
+audit.

package/indexers/bundles/context-code-indexer/tests/fixtures/chapters.json

@@ -0,0 +1,226 @@
+[
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-monorepo-container-chapter",
+    "anonymized": true,
+    "profile": "monorepo-container",
+    "canonical_facts": { "target": { "eligible": true, "bundle_compact_eligible": true } },
+    "artifact_policy_variant": "compact",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:responsibility-and-entry",
+    "title": "Anonymous repository topology",
+    "sections": ["Scope and entry", "Project boundaries", "Build and delivery evidence"],
+    "evidence_condition": "Render only from a complete project inventory and current build evidence.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-web-application-chapter",
+    "anonymized": true,
+    "profile": "web-application",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:dispatch-and-routing",
+    "title": "Anonymous application routes",
+    "sections": ["Application entry", "Route and page families", "Data and failure boundaries"],
+    "evidence_condition": "Render only from registered entries, routes, and source-backed handoffs.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-component-library-chapter",
+    "anonymized": true,
+    "profile": "component-library",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:public-capability",
+    "title": "Anonymous component family",
+    "sections": ["Supported imports", "Composition and variants", "Source-backed usage"],
+    "evidence_condition": "Render only for a public component family with current contract evidence.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-sdk-library-chapter",
+    "anonymized": true,
+    "profile": "sdk-library",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:examples-and-usage",
+    "title": "Anonymous capability family",
+    "sections": ["Consumer purpose", "Initialization and lifecycle", "Maintained examples"],
+    "evidence_condition": "Render only when the public entry and maintained usage are both evidenced.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-cli-tool-chapter",
+    "anonymized": true,
+    "profile": "cli-tool",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:dispatch-and-routing",
+    "title": "Anonymous command family",
+    "sections": ["Command entry", "Arguments and dispatch", "Exit and recovery behavior"],
+    "evidence_condition": "Render only from registered commands and their current handlers.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-plugin-extension-chapter",
+    "anonymized": true,
+    "profile": "plugin-extension",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:compatibility-and-extension",
+    "title": "Anonymous extension boundary",
+    "sections": ["Host contract", "Activation and lifecycle", "Compatibility limits"],
+    "evidence_condition": "Render only when host and extension identities are source-backed.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-api-service-chapter",
+    "anonymized": true,
+    "profile": "api-service",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:public-capability",
+    "title": "Anonymous service boundary",
+    "sections": ["Protocol registration", "Operation families", "Handler and downstream handoff"],
+    "evidence_condition": "Render only from a complete operation inventory and authoritative registration.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-gateway-facade-chapter",
+    "anonymized": true,
+    "profile": "gateway-facade",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:dependency-handoff",
+    "title": "Anonymous gateway handoff",
+    "sections": ["Inbound boundary", "Mapping and policy", "Downstream catalog"],
+    "evidence_condition": "Render only when both registration and downstream call evidence are current.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-domain-service-chapter",
+    "anonymized": true,
+    "profile": "domain-service",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:state-and-consistency",
+    "title": "Anonymous stateful capability",
+    "sections": ["Capability entry", "State and transaction boundary", "Failure and consistency"],
+    "evidence_condition": "Render only from observed state operations and adjacent consistency evidence.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-background-runtime-chapter",
+    "anonymized": true,
+    "profile": "background-runtime",
+    "canonical_facts": { "target": { "eligible": true, "bundle_compact_eligible": true } },
+    "artifact_policy_variant": "compact",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:dispatch-and-routing",
+    "title": "Anonymous scheduled runtime",
+    "sections": ["Trigger", "Dispatch branches", "Retry and completion"],
+    "evidence_condition": "Render only from a registered trigger and complete branch disposition.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-event-consumer-chapter",
+    "anonymized": true,
+    "profile": "event-consumer",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:failure-recovery",
+    "title": "Anonymous event consumer",
+    "sections": ["Subscription and dispatch", "Processing outcome", "Retry and delivery"],
+    "evidence_condition": "Render only from source-backed subscription, handler, and failure evidence.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-data-sync-reconciliation-chapter",
+    "anonymized": true,
+    "profile": "data-sync-reconciliation",
+    "canonical_facts": { "target": { "eligible": true, "bundle_expanded_eligible": true } },
+    "artifact_policy_variant": "expanded",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:state-and-consistency",
+    "title": "Anonymous reconciliation flow",
+    "sections": ["Source and trigger", "Transformation and sink", "Checkpoint and repair"],
+    "evidence_condition": "Render only when source, transformation, sink, and recovery boundaries are closed.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-storage-repository-chapter",
+    "anonymized": true,
+    "profile": "storage-repository",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:public-capability",
+    "title": "Anonymous storage boundary",
+    "sections": ["Owned data surface", "Read and write capabilities", "Consistency and failure"],
+    "evidence_condition": "Render only from current schema, query, or client evidence within scope.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-adapter-integration-chapter",
+    "anonymized": true,
+    "profile": "adapter-integration",
+    "canonical_facts": { "target": { "eligible": true, "bundle_compact_eligible": true } },
+    "artifact_policy_variant": "compact",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:dependency-handoff",
+    "title": "Anonymous adapter boundary",
+    "sections": ["Input contract", "Transformation", "Output and failure mapping"],
+    "evidence_condition": "Render only when both sides of the adaptation are explicitly evidenced.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-contract-source-chapter",
+    "anonymized": true,
+    "profile": "contract-source",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:authority-and-generation",
+    "title": "Anonymous protocol authority",
+    "sections": ["Authoritative source", "Services and operations", "Generation and compatibility"],
+    "evidence_condition": "Render only from a fixed contract source and explicit generation boundary.",
+    "empty_behavior": "omit-chapter"
+  },
+  {
+    "protocol": "context.indexer.chapter-fixture/v1",
+    "id": "anonymous-derived-generated-source-chapter",
+    "anonymized": true,
+    "profile": "derived-generated-source",
+    "canonical_facts": { "target": { "eligible": true, "bundle_compact_eligible": true } },
+    "artifact_policy_variant": "compact",
+    "artifact_kind": "content",
+    "reader_question_ref": "question:authority-and-generation",
+    "title": "Anonymous generated surface",
+    "sections": ["Generated boundary", "Upstream authority", "Runtime consumers"],
+    "evidence_condition": "Render only when generator, upstream authority, and consumers are identifiable.",
+    "empty_behavior": "omit-chapter"
+  }
+]

package/indexers/bundles/context-code-indexer/tests/fixtures/composers.json

@@ -0,0 +1,82 @@
+[
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-public-contract",
+    "anonymized": true,
+    "composer": "public-contract",
+    "profile": "component-library",
+    "primary_input": { "fact_kinds": ["public-surface"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "contract" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-protocol-boundary",
+    "anonymized": true,
+    "composer": "protocol-boundary",
+    "profile": "web-application",
+    "primary_input": { "fact_kinds": ["protocol-operation"], "artifact_kinds": ["contract"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "contract" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-cross-module-chain",
+    "anonymized": true,
+    "composer": "cross-module-chain",
+    "profile": "monorepo-container",
+    "primary_input": { "fact_kinds": ["module-dependency"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "content" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-contracts-and-chains",
+    "anonymized": true,
+    "composer": "contracts-and-chains",
+    "profile": "monorepo-container",
+    "primary_input": { "fact_kinds": ["contract-binding", "module-dependency"], "artifact_kinds": ["contract"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "contract" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-event-flow",
+    "anonymized": true,
+    "composer": "event-flow",
+    "profile": "web-application",
+    "primary_input": { "fact_kinds": ["event-binding"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "content" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-persistence-boundary",
+    "anonymized": true,
+    "composer": "persistence-boundary",
+    "profile": "api-service",
+    "primary_input": { "fact_kinds": ["persistence-binding"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "content" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-examples-and-documentation",
+    "anonymized": true,
+    "composer": "examples-and-documentation",
+    "profile": "monorepo-container",
+    "primary_input": { "fact_kinds": ["example-candidate"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "examples" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  },
+  {
+    "protocol": "context.indexer.composer-fixture/v1",
+    "id": "anonymous-development-and-delivery",
+    "anonymized": true,
+    "composer": "development-and-delivery",
+    "profile": "monorepo-container",
+    "primary_input": { "fact_kinds": ["development-entry"], "artifact_kinds": ["content"] },
+    "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "content" },
+    "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
+  }
+]