@c4a/context-cli 0.7.9 → 0.7.10-alpha.2

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

@@ -7,10 +7,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-monorepo-container",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -20,10 +32,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-web-application",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -33,10 +57,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-component-library",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -46,10 +82,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-sdk-library",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -59,10 +107,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-cli-tool",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -72,10 +132,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-plugin-extension",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -85,10 +157,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-api-service",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -98,10 +182,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-gateway-facade",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -111,10 +207,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-domain-service",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -124,10 +232,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-background-runtime",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -137,10 +257,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-event-consumer",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -150,10 +282,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-data-sync-reconciliation",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -163,10 +307,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-storage-repository",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -176,10 +332,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-adapter-integration",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -189,10 +357,22 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-contract-source",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   },
   {
     "protocol": "context.indexer.authoring-fixture/v1",
@@ -202,9 +382,21 @@
     "source_role": "authoritative-source",
     "logical_unit_id": "semantic-subject",
     "logical_unit_ref": "node:anonymous-derived-generated-source",
-    "canonical_facts": { "target": { "eligible": true } },
+    "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"]
+    "artifacts": [
+      {
+        "artifact_id": "content",
+        "artifact_kind": "content",
+        "purpose": "required",
+        "reader_question_refs": [
+          "question:failure-recovery"
+        ]
+      }
+    ]
   }
 ]

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

@@ -1,6 +1,6 @@
 ---
 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.
+description: Use when the user explicitly asks to create a new Context Indexer Skill for code, documents, notes or session summaries. Do not activate for indexing existing sources, ordinary coding, knowledge queries or selecting an installed skill.
 user-invocable: false
 metadata:
   context-role: "authoring-assistant"
@@ -9,72 +9,33 @@ metadata:
 
 # 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.
+Create a reusable skill in the user's chosen directory. This assistant writes
+skills; it does not initialize a knowledge workspace or start production.
+Use the conversation language and ask only for missing source, reader or
+capability choices that materially affect the requested result.
+
+Read [the authoring guide](references/guides/indexer-skill-creation.md).
+When a relevant example is available, inspect its actual host-visible SKILL.md
+and only the references needed for this source family. Do not crawl caches,
+load every installed skill or require an exact Provider version.
+
+Every Indexer starts with a useful skeleton: source structure, recognizable
+features, names, counts when actually established, and entry locations.
+Planning may use direct Agent investigation or a bounded helper appropriate
+to the technology. Detailed parsing and behavior analysis are separate,
+optional writing-time work. One module may use several skills.
+
+Deliver SKILL.md and only useful references, templates or scripts. Do not
+generate a Provider registration manifest, primary/extension binding, version
+or hash verification flow, per-symbol fact ledger or persistent producer log.
+The current Context stage supplies purpose, scope, scheduling and submission
+schemas; the new skill contributes investigation and writing guidance.
+
+Validate the skill's references and any scripts, then exercise realistic
+anonymous material for its claimed capability. Distinguish static validation
+from model output review and a real production run. Do not silently install
+dependencies or claim tests that could not run.
+
+Report created files, supported inputs, bounded helper behavior and remaining
+limitations. Installation makes a skill available, not selected. Start actual
+Context production only when requested, through its existing entry and route.