@c4a/context-cli 0.7.4 → 0.7.8

package/plugins/skills/context-code-indexer/templates/sdk-library-public-api-reference.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "sdk-library-public-api-reference",
+  "profile": "sdk-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/plugins/skills/context-code-indexer/templates/sdk-library-usage-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "sdk-library-usage-guide",
+  "profile": "sdk-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/plugins/skills/context-code-indexer/templates/storage-repository-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "storage-repository-maintenance-guide",
+  "profile": "storage-repository",
+  "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/plugins/skills/context-code-indexer/templates/storage-repository-public-api-reference.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "storage-repository-public-api-reference",
+  "profile": "storage-repository",
+  "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/plugins/skills/context-code-indexer/templates/web-application-federation-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "web-application-federation-guide",
+  "profile": "web-application",
+  "reader_goal": "integrate-host-and-remote",
+  "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-host-and-remote",
+      "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": "Distinguish host and remote declarations, mount and expose contracts, shared dependencies, lifecycle, environment expressions and consumption. A declaration is not a verified running remote.",
+    "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/plugins/skills/context-code-indexer/templates/web-application-maintenance-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "web-application-maintenance-guide",
+  "profile": "web-application",
+  "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/plugins/skills/context-code-indexer/templates/web-application-page-task-guide.md

@@ -0,0 +1,81 @@
+---
+{
+  "protocol": "context.indexer.template/v1",
+  "template_id": "web-application-page-task-guide",
+  "profile": "web-application",
+  "reader_goal": "develop-page-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": "develop-page-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": "Follow one page task through route and access entry, user interaction, state, loading and submission, result and change entrypoints. Internal components are not published libraries.",
+    "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/plugins/skills/context-code-indexer/tests/fixtures/composers.json

@@ -5,7 +5,7 @@
     "anonymized": true,
     "composer": "public-contract",
     "profile": "component-library",
-    "primary_input": { "fact_kinds": ["public-surface"], "artifact_kinds": ["content"] },
+    "primary_input": { "fact_kinds": ["code-symbol"], "artifact_kinds": ["content"] },
     "expected_proposal": { "artifact_policy_variant": "standard", "artifact_kind": "contract" },
     "empty_result": { "protocol": "context.indexer.layer-fragment-result/v1", "fragments": [] }
   },

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

@@ -110,7 +110,7 @@
       "scenario_id": "unresolved-authoring-placeholder",
       "authoring_fixture_ref": "anonymous-background-runtime",
       "observed_condition": "generated-placeholder-remains",
-      "expected_outcome": "block-generated-placeholder"
+      "expected_outcome": "agent-review-advisory"
     },
     {
       "scenario_id": "missing-runtime-platform-fact",

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

@@ -0,0 +1,80 @@
+---
+name: context-indexer-create
+description: Use when the user explicitly asks to create a new Context Indexer Provider Skill for code, documents, notes or session summaries. Do not activate for indexing existing sources, ordinary coding, knowledge queries or selecting an installed Provider.
+user-invocable: false
+metadata:
+  context-role: "authoring-assistant"
+  context-public-entry: "false"
+---
+
+# Create a Context Indexer
+
+Create a reusable Provider in the user's chosen directory. This is a Skill-writing
+assistant, not a Provider or a production Route. Use the conversation language.
+An explicit request to make a new Indexer is sufficient; the user need not name
+this Skill. Do not initialize a knowledge workspace to write a Provider.
+
+## Establish the intended result
+
+Reuse the stated source type, readers, tasks and desired output. Ask only about
+missing choices that affect interpretation or ownership: should the new Provider
+replace an existing primary, or contribute to another Provider's pages? Notes
+may become FAQs, decisions or corrections; session summaries may or may not link
+to code changes. Do not force a taxonomy, a commit association, or one page per
+source. Distinguish a reusable Provider from a workspace-only wording/template
+change; explain the smaller option without refusing a requested new Provider.
+
+## Read the matching contracts and examples
+
+Read [the authoring guide](references/guides/indexer-skill-creation.md), then the
+relevant sections of [the Provider protocol](references/reference/indexer-provider-protocol.md).
+Use the SDK version compatible with the intended CLI, rather than recalling
+schema fields from another release. These references are copied from the SDK
+at plugin build time; the installed schema remains the executable authority.
+
+- Code: [Code authoring](references/guides/code-indexer-skill-authoring.md).
+- Documents: [Markdown authoring](references/guides/markdown-indexer-skill-authoring.md).
+- Notes: [Note sources](references/guides/note.md).
+- Sessions: [Session sources](references/guides/sessions.md).
+- Composition and selection: [Provider customization](references/guides/indexer-provider-and-customization.md).
+
+Inspect the matching existing Provider's actual SKILL.md, context-indexer.yaml,
+selected instruction references and one relevant template. Use a Host-visible
+Skill path or the installed CLI catalog's guidance paths; do not crawl host
+caches or require this repository's developer paths. If examples or the SDK are
+unavailable, explain which validation remains unavailable. Do not invent a
+successful validation or silently install dependencies.
+
+## Write a complete, bounded Provider
+
+Deliver SKILL.md, context-indexer.yaml, the declared instructions and useful
+page templates. Add anonymous fixtures and validation instructions. Add programs
+only for an actual unsupported extraction need; ordinary source interpretation
+and writing belong to the Agent. Derive manifest capabilities and resources
+from what the new bundle actually implements, not everything in the example.
+
+Use one context.indexer.provider/v1 manifest for all four source families.
+Note and Sessions currently use the markdown domain with their own target kinds
+and profiles; do not invent new protocol domains. A resource must be declared
+so the lifecycle can send it to the Agent: an unreferenced reference file is
+not enough. Preserve stable source/subject identity, evidence bindings and
+revision boundaries; keep nonessential metadata out of knowledge frontmatter.
+
+The new Provider does not own source authorization, scheduling, approval,
+close/build or publication. Return the current operation's declared results.
+Do not turn suggestions in notes or sessions into established implementation
+facts, and do not manufacture raw transcripts from summaries.
+
+## Validate and hand off
+
+Follow the guide's manifest, resource, template and fixture checks in an isolated
+test directory. Test the intended reader output, insufficient material, revision
+of an existing page, and composition when advertised. Cover only the source
+families claimed by this Provider. Report static validation separately from an
+actual lifecycle run; a valid YAML file alone is not a working Provider.
+
+Summarize the created files, supported inputs, ownership/composition, tests and
+remaining limitations. Explain the user's chosen installation channel and host
+Skill switch. Installation/enabling does not select a Provider for a workspace.
+Only hand off to the existing Context production Skill when the user asks to
+use it there; that Skill follows a fresh Route for Provider selection.