@c4a/context-cli 0.6.18 → 0.7.0

package/plugins/skills/context-code-indexer/tests/fixtures/profiles.json

@@ -0,0 +1,210 @@
+[
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-monorepo-container",
+    "anonymized": true,
+    "profile": "monorepo-container",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-monorepo-container",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-monorepo-container-source"] }],
+    "evidence_refs": ["evidence:anonymous-monorepo-container-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-web-application",
+    "anonymized": true,
+    "profile": "web-application",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-web-application",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-web-application-source"] }],
+    "evidence_refs": ["evidence:anonymous-web-application-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-component-library",
+    "anonymized": true,
+    "profile": "component-library",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-component-library",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-component-library-source"] }],
+    "evidence_refs": ["evidence:anonymous-component-library-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-sdk-library",
+    "anonymized": true,
+    "profile": "sdk-library",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-sdk-library",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-sdk-library-source"] }],
+    "evidence_refs": ["evidence:anonymous-sdk-library-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-cli-tool",
+    "anonymized": true,
+    "profile": "cli-tool",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-cli-tool",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-cli-tool-source"] }],
+    "evidence_refs": ["evidence:anonymous-cli-tool-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-plugin-extension",
+    "anonymized": true,
+    "profile": "plugin-extension",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-plugin-extension",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-plugin-extension-source"] }],
+    "evidence_refs": ["evidence:anonymous-plugin-extension-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-api-service",
+    "anonymized": true,
+    "profile": "api-service",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-api-service",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-api-service-source"] }],
+    "evidence_refs": ["evidence:anonymous-api-service-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-gateway-facade",
+    "anonymized": true,
+    "profile": "gateway-facade",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-gateway-facade",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-gateway-facade-source"] }],
+    "evidence_refs": ["evidence:anonymous-gateway-facade-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-domain-service",
+    "anonymized": true,
+    "profile": "domain-service",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-domain-service",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-domain-service-source"] }],
+    "evidence_refs": ["evidence:anonymous-domain-service-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-background-runtime",
+    "anonymized": true,
+    "profile": "background-runtime",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-background-runtime",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-background-runtime-source"] }],
+    "evidence_refs": ["evidence:anonymous-background-runtime-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-event-consumer",
+    "anonymized": true,
+    "profile": "event-consumer",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-event-consumer",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-event-consumer-source"] }],
+    "evidence_refs": ["evidence:anonymous-event-consumer-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-data-sync-reconciliation",
+    "anonymized": true,
+    "profile": "data-sync-reconciliation",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-data-sync-reconciliation",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-data-sync-reconciliation-source"] }],
+    "evidence_refs": ["evidence:anonymous-data-sync-reconciliation-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-storage-repository",
+    "anonymized": true,
+    "profile": "storage-repository",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-storage-repository",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-storage-repository-source"] }],
+    "evidence_refs": ["evidence:anonymous-storage-repository-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-adapter-integration",
+    "anonymized": true,
+    "profile": "adapter-integration",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-adapter-integration",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-adapter-integration-source"] }],
+    "evidence_refs": ["evidence:anonymous-adapter-integration-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-contract-source",
+    "anonymized": true,
+    "profile": "contract-source",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-contract-source",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-contract-source-source"] }],
+    "evidence_refs": ["evidence:anonymous-contract-source-source"]
+  },
+  {
+    "protocol": "context.indexer.authoring-fixture/v1",
+    "id": "anonymous-derived-generated-source",
+    "anonymized": true,
+    "profile": "derived-generated-source",
+    "source_role": "authoritative-source",
+    "logical_unit_id": "semantic-subject",
+    "logical_unit_ref": "node:anonymous-derived-generated-source",
+    "canonical_facts": { "target": { "eligible": true } },
+    "artifact_policy_variant": "standard",
+    "artifacts": [{ "artifact_id": "content", "artifact_kind": "content", "purpose": "required", "reader_question_refs": ["question:failure-recovery"], "evidence_refs": ["evidence:anonymous-derived-generated-source-source"] }],
+    "evidence_refs": ["evidence:anonymous-derived-generated-source-source"]
+  }
+]

package/plugins/skills/context-code-indexer/tests/fixtures/scenarios.json

@@ -0,0 +1,122 @@
+{
+  "protocol": "context.indexer.community-scenario-fixture-set/v1",
+  "anonymized": true,
+  "positive_cases": [
+    {
+      "scenario_id": "rpc-query-catalog",
+      "authoring_fixture_ref": "anonymous-api-service",
+      "member_kind": "protocol-method",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "catalog-only",
+      "expected_artifact_behavior": "no-standalone-artifact",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "http-handler-flow",
+      "authoring_fixture_ref": "anonymous-api-service",
+      "member_kind": "handler",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "gateway-handoff",
+      "authoring_fixture_ref": "anonymous-gateway-facade",
+      "member_kind": "downstream-callsite",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "event-flow",
+      "authoring_fixture_ref": "anonymous-event-consumer",
+      "member_kind": "event-branch",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "function-runtime",
+      "authoring_fixture_ref": "anonymous-background-runtime",
+      "member_kind": "event-branch",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "scheduled-worker",
+      "authoring_fixture_ref": "anonymous-background-runtime",
+      "member_kind": "timer-branch",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "reconciliation-flow",
+      "authoring_fixture_ref": "anonymous-data-sync-reconciliation",
+      "member_kind": "state-transition",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "stateful-service",
+      "authoring_fixture_ref": "anonymous-domain-service",
+      "member_kind": "state-transition",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "detailed",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "repository-boundary",
+      "authoring_fixture_ref": "anonymous-storage-repository",
+      "member_kind": "store",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "boundary-only",
+      "expected_artifact_behavior": "evidence-backed-content",
+      "expected_bundle_artifact_ids": ["content"]
+    },
+    {
+      "scenario_id": "library-capability",
+      "authoring_fixture_ref": "anonymous-sdk-library",
+      "member_kind": "method",
+      "expected_inventory_disposition": "owned",
+      "expected_projection_disposition": "capability-group",
+      "expected_artifact_behavior": "capability-family-artifact",
+      "expected_bundle_artifact_ids": ["content"]
+    }
+  ],
+  "negative_cases": [
+    {
+      "scenario_id": "complete-page-stale-source",
+      "authoring_fixture_ref": "anonymous-api-service",
+      "observed_condition": "source-revision-or-locator-drift",
+      "expected_outcome": "reject-stale-evidence"
+    },
+    {
+      "scenario_id": "one-method-one-page-inflation",
+      "authoring_fixture_ref": "anonymous-api-service",
+      "observed_condition": "method-count-equals-artifact-count",
+      "expected_outcome": "reject-artifact-inflation"
+    },
+    {
+      "scenario_id": "unresolved-authoring-placeholder",
+      "authoring_fixture_ref": "anonymous-background-runtime",
+      "observed_condition": "generated-placeholder-remains",
+      "expected_outcome": "block-generated-placeholder"
+    },
+    {
+      "scenario_id": "missing-runtime-platform-fact",
+      "authoring_fixture_ref": "anonymous-gateway-facade",
+      "observed_condition": "required-runtime-fact-absent",
+      "expected_outcome": "request-material"
+    }
+  ]
+}

package/plugins/skills/context-markdown-indexer/SKILL.md

@@ -0,0 +1,20 @@
+---
+name: context-markdown-indexer
+description: Context-managed Provider for evidence-bound document knowledge. Use only when the Context Indexer lifecycle selects this Provider, not as a standalone workflow.
+metadata:
+  context-role: "indexer-provider"
+  context-public-entry: "false"
+  context-provider-version: "1.0.0"
+---
+
+# Context Markdown Indexer
+
+Provider authors must satisfy
+`node_modules/@c4a/context/docs/guides/markdown-indexer-skill-authoring.md` and
+the shared Provider/customization guide before publishing or extending this
+Skill. Those documents are authoring contracts; the current captured evidence,
+workset and Route remain execution authority.
+
+Use this Provider only through the Context Indexer lifecycle. Context supplies exact captured sources, profile authority, worksets, and evidence views; the Provider does not read arbitrary workspace paths or write approved knowledge directly.
+
+The machine-readable authority is `context-indexer.yaml`. Context materializes the detailed guidance only after verifying this Bundle's release identity and complete file ledger.

package/plugins/skills/context-markdown-indexer/context-indexer.yaml

@@ -0,0 +1,147 @@
+protocol: context.indexer.provider/v1
+id: context-markdown-indexer
+version: 1.0.0
+domains: [markdown]
+
+activation:
+  target_kinds: [document, document-set, documentation-site]
+  required_signals:
+    - id: captured-document
+      description: The registered target scope contains a current captured Markdown or structured document snapshot.
+  supporting_signals:
+    - id: explicit-audience
+      description: The source identifies a reader, task, policy, decision, procedure, or reference boundary.
+    - id: cross-source-evidence
+      description: The readable scope contains current corroborating material for unresolved claims.
+  negative_signals:
+    - id: transient-conversation
+      description: The material is an unapproved transient conversation without a durable source identity.
+  agent_questions:
+    - Which reader goal and authority apply to each source-backed Section?
+
+provides:
+  profiles:
+    - domain-reference
+    - product-requirements
+    - technical-guide
+    - user-and-developer-guide
+    - public-api-reference
+    - runbook
+    - faq-support
+    - standard-policy
+    - decision-record
+    - incident-review
+    - test-validation
+    - release-migration-guide
+    - documentation-site
+  operations:
+    - id: main-index
+      consumes: context.indexer.main-workset/v1
+      produces: context.indexer.main-result/v1
+      accepts_layer_fragments: [fact-enrichment, template-variables]
+    - id: material-answer
+      consumes: context.indexer.material-question-workset/v1
+      produces: context.indexer.material-answer-result/v1
+      supported_evidence_kinds: [contract, configuration, documentation, runbook, decision-record, test-result, runtime-observation, tool-snapshot]
+      accepts_layer_fragments: [fact-enrichment]
+  source_roles: [authoritative-document, supporting-document, operational-document, decision-record]
+  logical_units:
+    - id: reader-subject
+      identity: canonical-subject-key
+      artifacts:
+        recommended: [content]
+        supported_policy_variants: [standard]
+
+provider:
+  instructions:
+    - path: references/indexer.md
+      profiles:
+        - domain-reference
+        - product-requirements
+        - technical-guide
+        - user-and-developer-guide
+        - public-api-reference
+        - runbook
+        - faq-support
+        - standard-policy
+        - decision-record
+        - incident-review
+        - test-validation
+        - release-migration-guide
+        - documentation-site
+    - path: references/classification.md
+      profiles:
+        - domain-reference
+        - product-requirements
+        - technical-guide
+        - user-and-developer-guide
+        - public-api-reference
+        - runbook
+        - faq-support
+        - standard-policy
+        - decision-record
+        - incident-review
+        - test-validation
+        - release-migration-guide
+        - documentation-site
+    - path: references/structure-and-artifacts.md
+      profiles:
+        - domain-reference
+        - product-requirements
+        - technical-guide
+        - user-and-developer-guide
+        - public-api-reference
+        - runbook
+        - faq-support
+        - standard-policy
+        - decision-record
+        - incident-review
+        - test-validation
+        - release-migration-guide
+        - documentation-site
+    - path: references/semantic-planning.md
+      profiles:
+        - domain-reference
+        - product-requirements
+        - technical-guide
+        - user-and-developer-guide
+        - public-api-reference
+        - runbook
+        - faq-support
+        - standard-policy
+        - decision-record
+        - incident-review
+        - test-validation
+        - release-migration-guide
+        - documentation-site
+    - path: references/editorial-policy.md
+      profiles:
+        - domain-reference
+        - product-requirements
+        - technical-guide
+        - user-and-developer-guide
+        - public-api-reference
+        - runbook
+        - faq-support
+        - standard-policy
+        - decision-record
+        - incident-review
+        - test-validation
+        - release-migration-guide
+        - documentation-site
+  forbidden_fallbacks: [whole-document-single-classification, unsupported-section-publication, inferred-authority]
+  completion_checks: [section-disposition-closure, source-authority-binding, material-gap-closure]
+
+customization:
+  supports: [config, instructions-append, template-override, program-extend]
+
+quality_guidance:
+  metric_ids:
+    - inventory-disposition-coverage
+    - duplicated-fact-target-ratio
+    - narrative-enumeration-ratio
+    - normalized-template-repetition-ratio
+    - implementation-body-ratio
+    - reference-only-reader-targets
+    - unresolved-ordinal-partitions
+    - discretionary-artifacts-per-logical-unit

package/plugins/skills/context-markdown-indexer/references/classification.md

@@ -0,0 +1,63 @@
+# Section classification and projection intent
+
+Classify evidence at Section granularity. A profile describes the source family;
+it does not force one whole document into one reader purpose. For every emitted
+Section, choose the semantic `document_kind`, `reader_goal`, and
+`artifact_kind` before grouping Sections into Artifacts.
+
+Use body evidence, source authority, audience, and the reader task. File names,
+URLs, headings, navigation labels, and the selected profile are hints, not proof
+that every Section has the same intent. Do not infer authority from polished
+language or an official-looking path.
+
+## Canonical projection vocabulary
+
+The current community Markdown profiles use the following semantic intents.
+The CLI profile contract owns their stable storage projection; this table does
+not authorize a collection or output path.
+
+| Profile or Section family | Use when the evidence primarily… | `document_kind` | `reader_goal` | `artifact_kind` |
+| --- | --- | --- | --- | --- |
+| `domain-reference` | defines a durable domain, vocabulary, boundary, or business concept | `domain-reference` | `understand-domain` | `content` |
+| `product-requirements` | states product intent, behavior, scope, actors, or acceptance needs | `product-requirements` | `understand-product-intent` | `content` |
+| `technical-guide` | explains architecture, runtime behavior, interfaces, or design constraints | `technical-guide` | `understand-technical-design` | `content` |
+| user/developer product guidance | explains a user-visible capability or product behavior | `product-requirements` | `understand-product-intent` | `content` |
+| user/developer technical guidance | explains implementation-facing design or integration context | `technical-guide` | `understand-technical-design` | `content` |
+| user/developer task guidance | gives a repeatable task, setup, operation, or troubleshooting sequence | `task-guide` | `complete-reader-task` | `content` |
+| public API contract | supports lookup of public operations, fields, compatibility, or examples | `public-api-reference` | `look-up-public-contract` | `content` |
+| public contract policy | states normative compatibility or usage constraints around a public contract | `public-contract-policy` | `follow-public-contract-policy` | `content` |
+| `runbook` | directs operation, diagnosis, mitigation, recovery, or rollback | `runbook` | `operate-or-recover-system` | `content` |
+| `faq-support` | answers a durable reader question with reusable evidence | `faq-support` | `resolve-reader-question` | `content` |
+| `standard-policy` | defines a stable rule, standard, policy, or compliance boundary | `standard-policy` | `follow-standard-or-policy` | `content` |
+| `decision-record` | records alternatives, a choice, rationale, and consequences | `decision-record` | `understand-decision-and-tradeoffs` | `content` |
+| `incident-review` | records impact, timeline, cause, response, and follow-up learning | `incident-review` | `learn-from-incident` | `content` |
+| `test-validation` | defines or reports verification, acceptance, or observed results | `test-validation` | `verify-behavior-or-acceptance` | `content` |
+| release explanation | explains what changed, compatibility, or release impact | `release-guide` | `understand-release-change` | `content` |
+| migration procedure | tells a reader how to migrate, verify, and recover | `migration-guide` | `complete-migration` | `content` |
+
+`documentation-site` is an umbrella router. Apply the matching row above to
+each source-backed Section; do not invent a site-wide projection intent and do
+not collapse a multi-document site to one classification.
+
+## Classification order
+
+1. Establish the Section's current source authority and audience from the
+   authorized evidence view.
+2. State the concrete question the Section enables a reader to answer or task
+   it enables them to complete.
+3. Choose the narrowest matching `document_kind` and `reader_goal` pair from
+   the current profile contract.
+4. Use `artifact_kind: content` for the current community Markdown Bundle. Do
+   not invent a specialized Artifact kind unless the supplied profile contract
+   explicitly registers it.
+5. Return the intent on every actual or template-projected Section. Do not put
+   a collection, directory, filename, or package root in the Result.
+
+When a Section mixes multiple reader tasks, split it along continuous evidence
+boundaries. Keep one Section only when the material forms one coherent answer
+for one reader goal. A heading change alone does not require a split, and a
+shared heading does not justify combining unrelated tasks.
+
+If no registered intent fits, return a material/capability disposition instead
+of selecting the nearest label. Unsupported or authority-ambiguous material
+must not become a reader Artifact.