@c4a/context-cli 0.6.1-beta.6 → 0.6.2

package/cli.js

@@ -80200,7 +80200,7 @@ function renderProseSections(input) {
 function renderApprovedParentIndexMarkdown(input) {
   const localized = localizeProseSourceRefs([...new Set(input.record.source_refs)]);
   const title = input.record.review.title;
-  const description = input.record.review.summary.trim() || `${title} parent index.`;
+  const description = input.record.review.behavior_summary?.trim() || `${title} parent index.`;
   const nodeType = input.record.kind;
   const children = input.record.parent_index?.children;
   if (children === undefined || children.length === 0) {
@@ -80255,7 +80255,7 @@ function renderApprovedProseMarkdown(input) {
   const localized = localizeProseSourceRefs(canonicalRefs);
   const localRefsByCanonicalRef = new Map(canonicalRefs.map((ref2, index2) => [ref2, localized.localRefs[index2] ?? ""]));
   const title = input.record.review.title;
-  const description = input.record.review.summary.trim() || `${title} document knowledge.`;
+  const description = input.record.review.behavior_summary?.trim() || `${title} document knowledge.`;
   const nodeType = input.record.kind;
   const tags = [...new Set(["docs", "prose", nodeType, input.record.module].filter((tag) => tag.length > 0))];
   const frontmatter = import_yaml23.default.stringify({
@@ -81981,7 +81981,6 @@ import { dirname as dirname24, join as join39, posix as pathPosix, relative as r
 init_cliFeedback();
 init_errors();
 init_exitCode();
-var import_yaml25 = __toESM(require_dist3(), 1);
 
 // src/project/packageDistribution.ts
 function packageKnowledgeNamespace(pkg) {
@@ -82101,6 +82100,122 @@ function planKnowledgeDirectoryIndexes(items, navigation) {
   }).sort((left, right) => left.relPath.localeCompare(right.relPath));
 }
 
+// src/project/packageKnowledgeProjection.ts
+var import_yaml25 = __toESM(require_dist3(), 1);
+var FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u;
+var CONTEXT_METADATA_BLOCK_RE = /<!--\s*context:(summary|source_refs|audit)\b[\s\S]*?\/context:\1\s*-->[ \t]*(?:\r?\n){0,2}/giu;
+var CONTEXT_SECTION_OPEN_RE = /^[ \t]*<!--\s*context:section\b[^>]*-->[ \t]*(?:\r?\n){0,2}/gimu;
+var CONTEXT_SECTION_CLOSE_RE = /(?:\r?\n)?^[ \t]*<!--\s*\/context:section\s*-->[ \t]*(?:\r?\n){0,2}/gimu;
+var PACKAGE_OMITTED_FIELDS = [
+  "node_ref",
+  "view_ref",
+  "node_type",
+  "node_tags",
+  "generated",
+  "children",
+  "visibility",
+  "code_symbols",
+  "relationship_mode",
+  "code_edges",
+  "candidate_fingerprint",
+  "resource",
+  "sources"
+];
+var PACKAGE_INVENTORY_FIELDS = [
+  "node_type",
+  "node_tags",
+  "generated",
+  "visibility",
+  "code_symbols",
+  "candidate_fingerprint"
+];
+var COMPILER_ONLY_TAGS = new Set(["docs", "prose", "parent-index"]);
+function isRecord15(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function stringList2(value) {
+  if (!Array.isArray(value))
+    return [];
+  return value.filter((item) => typeof item === "string" && item.trim().length > 0);
+}
+function parseKnowledgeFrontmatter(content3) {
+  const match = FRONTMATTER_RE.exec(content3);
+  if (match?.[1] === undefined)
+    return {};
+  try {
+    const parsed = import_yaml25.parse(match[1]);
+    return isRecord15(parsed) ? parsed : {};
+  } catch {
+    return {};
+  }
+}
+function isSourceRoutingTag(tag, sources) {
+  return sources.some((source3) => {
+    const separator = source3.indexOf(":");
+    if (separator < 0)
+      return false;
+    const locator = source3.slice(separator + 1);
+    return locator.startsWith(`${tag}/`);
+  });
+}
+function projectedTags(frontmatter) {
+  const sources = stringList2(frontmatter.sources);
+  return [...new Set([
+    ...stringList2(frontmatter.tags).filter((tag) => !COMPILER_ONLY_TAGS.has(tag) && !isSourceRoutingTag(tag, sources)),
+    ...stringList2(frontmatter.node_tags)
+  ])];
+}
+function packageKnowledgeDescription(value) {
+  if (typeof value !== "string")
+    return value;
+  const normalized = value.trim();
+  if (/^Reachable edges:\s[\s\S]*\.\s*$/u.test(normalized))
+    return;
+  const withoutGeneratedEdges = normalized.replace(/\s+Reachable edges:\s[\s\S]*\.\s*$/u, "").trim();
+  if (withoutGeneratedEdges.length > 0)
+    return withoutGeneratedEdges;
+  return normalized;
+}
+function packageKnowledgeFrontmatter(frontmatter) {
+  const projected = { ...frontmatter };
+  for (const field of PACKAGE_OMITTED_FIELDS)
+    delete projected[field];
+  const description = packageKnowledgeDescription(projected.description);
+  if (description === undefined)
+    delete projected.description;
+  else
+    projected.description = description;
+  const tags = projectedTags(frontmatter);
+  if (tags.length > 0)
+    projected.tags = tags;
+  else
+    delete projected.tags;
+  return projected;
+}
+function packageKnowledgeMetadata(frontmatter) {
+  const metadata = {};
+  for (const field of PACKAGE_INVENTORY_FIELDS) {
+    if (frontmatter[field] !== undefined)
+      metadata[field] = frontmatter[field];
+  }
+  return Object.keys(metadata).length > 0 ? metadata : undefined;
+}
+function projectPackageKnowledgeMarkdown(content3) {
+  const match = FRONTMATTER_RE.exec(content3);
+  if (match === null)
+    return content3;
+  const frontmatter = parseKnowledgeFrontmatter(content3);
+  if (Object.keys(frontmatter).length === 0)
+    return content3;
+  const body = content3.slice(match[0].length).replace(CONTEXT_METADATA_BLOCK_RE, "").replace(CONTEXT_SECTION_OPEN_RE, "").replace(CONTEXT_SECTION_CLOSE_RE, `
+`);
+  const yaml3 = import_yaml25.stringify(packageKnowledgeFrontmatter(frontmatter)).trimEnd();
+  return `---
+${yaml3}
+---
+${body}`;
+}
+
 // src/project/packageIndexes.ts
 var MARKDOWN_LINK_RE = /(?<!!)\[[^\]\n]*\]\(([^)\n]+)\)/gu;
 var OKF_OUTPUT_ROOTS = new Set(["wikis", "guides", "rules", "feats"]);
@@ -82145,20 +82260,6 @@ async function walkFiles2(root2) {
   files.sort((left, right) => left.relPath.localeCompare(right.relPath));
   return files;
 }
-function isRecord15(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function parseFrontmatter4(content3) {
-  const match = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(content3);
-  if (!match?.[1])
-    return {};
-  try {
-    const parsed = import_yaml25.parse(match[1]);
-    return isRecord15(parsed) ? parsed : {};
-  } catch {
-    return {};
-  }
-}
 function stringField5(record, key, fallback = "") {
   const value = record[key];
   return typeof value === "string" && value.trim().length > 0 ? value.trim() : fallback;
@@ -82233,7 +82334,9 @@ function addTreeNode(nodes, segments, item, depth = 0, prefix = "") {
 }
 function knowledgeInventory(files, templateRelPath, navigation = DEFAULT_PACKAGE_NAVIGATION, pkg) {
   const items = files.map((file) => {
-    const frontmatter = parseFrontmatter4(file.content);
+    const productionFrontmatter = parseKnowledgeFrontmatter(file.content);
+    const frontmatter = packageKnowledgeFrontmatter(productionFrontmatter);
+    const productionMetadata = packageKnowledgeMetadata(productionFrontmatter);
     const logicalOutputRelPath = okfPackagePathForKnowledgePath(file.relPath);
     const outputRelPath = pkg === undefined ? logicalOutputRelPath : packageKnowledgeOutputPath(pkg, file.relPath);
     const sourcePath = file.relPath;
@@ -82241,12 +82344,12 @@ function knowledgeInventory(files, templateRelPath, navigation = DEFAULT_PACKAGE
     const { collection: okfRoot, pathWithinCollection, segments, parentPath } = splitKnowledgePath(logicalOutputRelPath);
     const okfRootPath = pkg === undefined ? okfRoot : packageOkfRootPath(pkg, okfRoot);
     const group = groupNameForSegments(segments);
-    const sources = Array.isArray(frontmatter.sources) ? frontmatter.sources : [];
+    const sources = Array.isArray(productionFrontmatter.sources) ? productionFrontmatter.sources : [];
     const firstSource = sources.find((source4) => typeof source4 === "string");
     const source3 = (firstSource ?? "").replace(/^repo:/u, "") || group;
     const hrefFromTemplate = relativeMarkdownHref(templateRelPath, outputRelPath);
-    const nodeRef = stringField5(frontmatter, "node_ref");
-    const viewRef = stringField5(frontmatter, "view_ref");
+    const nodeRef = stringField5(productionFrontmatter, "node_ref");
+    const viewRef = stringField5(productionFrontmatter, "view_ref");
     return {
       path: outputRelPath,
       sourcePath,
@@ -82273,7 +82376,8 @@ function knowledgeInventory(files, templateRelPath, navigation = DEFAULT_PACKAGE
       parentPath,
       depth: segments.length,
       segments,
-      tags: tagsField(frontmatter)
+      tags: tagsField(frontmatter),
+      ...productionMetadata === undefined ? {} : { production_metadata: productionMetadata }
     };
   });
   const byGroup = new Map;
@@ -82908,7 +83012,8 @@ function packageBuildInventory(input) {
         title: item.title,
         type: item.type,
         group: item.group,
-        source: item.source
+        source: item.source,
+        ...item.production_metadata === undefined ? {} : { production_metadata: item.production_metadata }
       })),
       groups: inventory.groups.map((group) => ({
         name: group.name,
@@ -83260,7 +83365,7 @@ init_workspace();
 init_packageTemplateReview();
 var KNOWLEDGE_ROOT4 = "knowledge";
 var PACKAGE_FINGERPRINT_ROOT = join42(".tmp", "context-runtime", "packages");
-var PACKAGE_BUILDER_PROTOCOL_VERSION = "v10-flat-package-roots";
+var PACKAGE_BUILDER_PROTOCOL_VERSION = "v11-consumer-frontmatter";
 function assertPackageOutputDir(pkg) {
   const expected = `dist/${pkg.name}`;
   if (pkg.outDir !== expected || !isSafeRelativePath2(pkg.outDir)) {
@@ -83487,7 +83592,7 @@ function knowledgeBundle(pkg, files) {
     if (file.relPath !== distPath) {
       lines.push(`<!-- approved_path: ${file.relPath} -->`, "");
     }
-    lines.push(file.content.trim());
+    lines.push(projectPackageKnowledgeMarkdown(file.content).trim());
     return lines.join(`
 `);
   }).join(`
@@ -83548,7 +83653,7 @@ async function writeSelectedKnowledge(input) {
     assertSafeRenderedPath2(outputRelPath, "knowledge path");
     const outputPath = join42(input.projectRoot, input.pkg.outDir, outputRelPath);
     await mkdir23(dirname26(outputPath), { recursive: true });
-    await writeFile19(outputPath, file.content, "utf8");
+    await writeFile19(outputPath, projectPackageKnowledgeMarkdown(file.content), "utf8");
     written++;
   }
   return written;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.6.1-beta.6",
+  "version": "0.6.2",
   "type": "module",
   "description": "Local CLI for capturing, compiling, and governing knowledge workspaces",
   "license": "MIT",
@@ -21,7 +21,7 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.2.3",
-    "@c4a/context": "0.6.1-beta.6",
+    "@c4a/context": "0.6.2",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",
     "handlebars": "^4.7.8",

package/plugins/VERSION

@@ -1 +1 @@
-0.6.1-beta.6
+0.6.2

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "context",
   "description": "Maintain a project-local knowledge workspace through init and next-step agent guidance.",
-  "version": "0.6.1-beta.6",
+  "version": "0.6.2",
   "author": {
     "name": "c4a"
   },

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "context",
-  "version": "0.6.1-beta.6",
+  "version": "0.6.2",
   "description": "Maintain a project-local knowledge workspace through init and next-step agent guidance.",
   "author": {
     "name": "c4a"
@@ -18,7 +18,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.1-beta.6",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.2",
     "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
     "developerName": "c4a",
     "category": "Productivity",

package/plugins/cursor/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "context",
   "displayName": "C4A Context",
-  "version": "0.6.1-beta.6",
+  "version": "0.6.2",
   "description": "Maintain a project-local knowledge workspace through init and next-step agent guidance.",
   "author": {
     "name": "Context4AI",

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.6.1-beta.6"
+    "version": "0.6.2"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -143,12 +143,12 @@
     {
       "id": "context.sdk.package-outputs",
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:bddba5a43edd230583dc286f74992e28a29bda73382799fa0ca0bf1a23014ec5"
+      "digest": "sha256:df6236373c23ffde93283b0999450250d90fa1e961185f83b9060a6ba56400fc"
     },
     {
       "id": "context.sdk.package-templates",
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:ea34fa9a683915c8508d95423e3d87111349fc927accad4761ecfa3bd3204db1"
+      "digest": "sha256:32d5fd550304d76fe011aadce4abcb0321f656c710cbeb91d964b463316561d5"
     },
     {
       "id": "context.sdk.project-api",
@@ -451,7 +451,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:ad1b825734418814f1ac3673d329070228b6b8004cd821c39a3224c6d30935dd"
+      "digest": "sha256:0edd1fb11947dbf99179fc715b1a9182a4ed8ffe2007ff1859c09eb2aba609d5"
     },
     {
       "path": "resources/diagnostics/projection-stale.md",
@@ -503,11 +503,11 @@
     },
     {
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:bddba5a43edd230583dc286f74992e28a29bda73382799fa0ca0bf1a23014ec5"
+      "digest": "sha256:df6236373c23ffde93283b0999450250d90fa1e961185f83b9060a6ba56400fc"
     },
     {
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:ea34fa9a683915c8508d95423e3d87111349fc927accad4761ecfa3bd3204db1"
+      "digest": "sha256:32d5fd550304d76fe011aadce4abcb0321f656c710cbeb91d964b463316561d5"
     },
     {
       "path": "resources/manuals/reference/project-api.md",
@@ -633,5 +633,5 @@
   "graphDependencies": {
     "workspace": []
   },
-  "digest": "sha256:9496e5137e372e4711605465046811bf322c53603bc7b8c5fbfa07df0862d0eb"
+  "digest": "sha256:f9d3b6ea8d0b93df323af7557c9729ecb328a260c5389ed8869c21e1290726d3"
 }

package/providers/context/provider.yaml

@@ -1,6 +1,6 @@
 schema: agent-graph.provider.v1
 id: c4a/context
-version: 0.6.1-beta.6
+version: 0.6.2
 name: Context workflow
 description: Internal work contract for Context knowledge workspaces.
 graphs:

package/providers/context/resources/manuals/guides/package-outputs.md

@@ -84,7 +84,11 @@ carries the structure-first query discipline: start from OKF directory indexes,
 inspect page `sources` / `context:section` source_ref metadata, cite
 page/section evidence, and report explicit gaps when the package does not cover
 a requested fact. It does not treat direct grep over bundled OKF root
-directories as the primary discovery path. Its final template-author section
+directories as the primary discovery path. When indexes do not narrow the
+scope, or a candidate page is too large to read directly, its bundled
+`scripts/search.mjs` provides deterministic BM25 ranking over mechanically
+bounded Markdown chunks. Search results are leads; page bodies and typed edge
+records remain the evidence. Its final template-author section
 requires package authors to replace or edit the generic routing when the
 package needs project-specific terminology, entry points, known limits, or
 task workflows. Authors may explicitly accept the generic default when it is
@@ -102,10 +106,12 @@ as `wikis/`, `guides/`, `rules/`, or `feats/`; when selected, `context build`
 copies them into the package and generates root-aware directory indexes for them
 as needed. Selected OKF roots always have an index; smaller child directories
 are folded into their nearest generated ancestor index by default. These roots
-contain Markdown with OKF fields and C4A extension fields at the top level, plus
-`context:section` source_ref span comments. C4A extension fields such as `sources`,
-`visibility`, and `code_symbols` are not nested under `context`, and page
-frontmatter does not contain `source_refs`. The package root is an agent
+contain consumer-oriented Markdown with reader-facing frontmatter and no Context
+lifecycle comments. Node identity, source metadata, code symbol lists,
+relationship records, generated-child records, and candidate fingerprints are
+kept out of each page. `context-build-inventory.json` maps distributed paths to
+approved knowledge paths and exposes package-visible structure; exact Section
+evidence remains in the mapped `knowledge/` page. The package root is an agent
 package; the OKF-compatible interchange surface is the selected OKF root
 subtrees under `dist/<package-name>/`. The required template entry and final
 output path are both `wikis/index.md`.

package/providers/context/resources/manuals/reference/package-templates.md

@@ -157,7 +157,9 @@ src/package-templates/
 │   │   └── index.md
 │   └── skills/
 │       └── knowledge-query/
-│           └── SKILL.md
+│           ├── SKILL.md
+│           └── scripts/
+│               └── search.mjs
 └── llms/
     └── llms.txt
 ```
@@ -181,6 +183,10 @@ The default kb template includes:
   default entry OKF root is `wikis/`; packages that select additional internal
   collections expose
   `guides/`, `rules/`, or `feats/` indexes when those roots are selected.
+- `skills/knowledge-query/scripts/search.mjs`, a dependency-free BM25 fallback
+  for exact terms, mixed keyword queries, and large Markdown indexes. It chunks
+  mechanically, returns inspectable paths and line ranges, and never replaces
+  source-backed relationship evidence.
 - `wikis/index.md`, the editable OKF bundle entry page for the generated
   `dist/<package-name>/wikis/` directory.
 
@@ -237,14 +243,15 @@ explicitly accept the unchanged default through the package-template Review
 Route. Do not add a package-name Skill by default; add one only when the user
 wants project-specific behavior beyond knowledge lookup.
 
-## C4A OKF Profile
+## Context OKF Profiles
 
-Approved Markdown and kb package OKF output are an OKF superset:
+Approved Markdown under `knowledge/` is the production source of truth:
 
 - top-level YAML frontmatter uses OKF fields such as `type`, `title`,
   `description`, `tags`, `timestamp`, and `resource`;
-- C4A extension metadata such as `sources`, `visibility`, and `code_symbols`
-  also lives at the top level;
+- Context production metadata such as `sources`, `node_type`, `visibility`,
+  `code_symbols`, relationship records, and `candidate_fingerprint` also lives
+  at the top level;
 - do not nest C4A extension metadata under `context`; fields such as
   `context.sources` and `context.code_symbols` are not part of the 0.6 profile;
 - section provenance lives in `<!-- context:section ... source_ref="..." -->`
@@ -253,6 +260,15 @@ Approved Markdown and kb package OKF output are an OKF superset:
   section source refs when needed;
 - do not add `context` or `schema` fields.
 
+Package knowledge pages under `dist/<package-name>/` use a consumer projection.
+They retain reader-facing fields such as `title`, `type`, `description`, `tags`,
+`timestamp`, and custom non-lifecycle fields. Node identity, `resource`,
+`sources`, Section evidence comments, and build-only fields are omitted from the
+page. `context-build-inventory.json` records the distributed path, approved
+knowledge path, node identity, source summary, and package-visible structure.
+Maintainers return to the mapped `knowledge/` page for exact `sources` and
+`source_ref` attribution. `knowledge/` is never rewritten by this projection.
+
 Accepted section `source_ref` forms:
 
 ```text
@@ -262,7 +278,7 @@ src-N#span:<heading-hint> L<start>-<end>@<span-hash>
 
 The code symbol form includes the source-relative file so same-name symbols in
 different files resolve to one exact symbol-index row. Consumers should still
-treat the complete `source_ref` as opaque. Codegraph pages keep
+treat the complete `source_ref` as opaque. Production codegraph pages keep
 `candidate_fingerprint` at the top level and do not duplicate this evidence in
 `code_origin`.
 
@@ -280,7 +296,7 @@ The OKF-compatible surface is the selected `wikis/`, `guides/`, `rules/`, and
 
 1. Selects approved Markdown from `knowledge/`.
 2. Renders all files from `template.path`.
-3. Copies selected approved Markdown into the package output.
+3. Projects selected approved Markdown into consumer-oriented package pages.
 4. For `llmsPackage`, appends selected knowledge to `llms.txt` when the template
    does not already use `{{knowledge}}` or `{{approvedKnowledge}}`.
 5. Writes deterministic package inventory such as
@@ -288,7 +304,9 @@ The OKF-compatible surface is the selected `wikis/`, `guides/`, `rules/`, and
 6. Writes output under `dist/<package-name>/`.
 
 `context-build-inventory.json` records what was selected and why. Each selected
-file includes `selected_by` entries such as `{ "kind": "collection" }`,
+file includes `selected_by` entries such as `{ "kind": "collection" }` and a
+`production_metadata` object for selected page-level production fields. Child
+and relationship records use the inventory's canonical structure projection,
 `{ "kind": "okf_root" }`, `{ "kind": "include" }`, or
 `{ "kind": "default" }`. The inventory also exposes package-visible typed
 edges under `structure.edge_records`; these records are filtered to edges whose