@c4a/context 0.7.4 → 0.7.8
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +17 -8
- package/README.zh-CN.md +15 -8
- package/docs/README.md +13 -1
- package/docs/README.zh-CN.md +13 -1
- package/docs/getting-started.md +95 -69
- package/docs/guides/agent-dialogue.md +19 -9
- package/docs/guides/agent-guide.md +52 -10
- package/docs/guides/code-indexer-skill-authoring.md +50 -5
- package/docs/guides/indexer-manifest-example.md +103 -0
- package/docs/guides/indexer-provider-and-customization.md +307 -31
- package/docs/guides/indexer-skill-creation.md +99 -0
- package/docs/guides/knowledge-updates.md +324 -0
- package/docs/guides/lark-resources.md +5 -1
- package/docs/guides/markdown-indexer-skill-authoring.md +25 -7
- package/docs/guides/note.md +37 -0
- package/docs/guides/package-outputs.md +22 -17
- package/docs/guides/sessions.md +50 -0
- package/docs/guides/workspace-commit.md +45 -0
- package/docs/guides/workspace-prepare.md +72 -0
- package/docs/guides/workspace-restore.md +59 -0
- package/docs/reference/code-extractors.md +23 -11
- package/docs/reference/indexer-provider-protocol.md +116 -22
- package/docs/reference/package-templates.md +10 -9
- package/docs/reference/project-api.md +47 -13
- package/docs/reference/template-variables.md +7 -7
- package/index.d.ts +11 -0
- package/index.js +1819 -584
- package/indexerAgentStepProtocol.d.ts +1284 -2060
- package/indexerApprovedKnowledge.d.ts +371 -0
- package/indexerArticlePlan.d.ts +83 -0
- package/indexerArtifact.d.ts +10 -7
- package/indexerArtifactDependencies.d.ts +7 -5
- package/indexerArtifactPolicy.d.ts +16 -16
- package/indexerArtifactResult.d.ts +76 -69
- package/indexerAuthoringFixture.d.ts +8 -8
- package/indexerAuthorizedWorksetView.d.ts +14 -14
- package/indexerBaseQuestionAmendment.d.ts +40 -0
- package/indexerCandidateCompile.d.ts +46 -36
- package/indexerCatalogFallback.d.ts +566 -48
- package/indexerCompositionFactDependencies.d.ts +16 -0
- package/indexerContentLayers.d.ts +6 -4
- package/indexerContractDeclaration.d.ts +3 -0
- package/indexerControlledProgram.d.ts +1039 -238
- package/indexerCustomizationDraft.d.ts +188 -0
- package/indexerDependencyView.d.ts +17 -17
- package/indexerEffectiveArtifact.d.ts +26 -15
- package/indexerExampleFactDependencies.d.ts +17 -0
- package/indexerExampleIdentityAudit.d.ts +2 -2
- package/indexerInventoryDisposition.d.ts +44 -44
- package/indexerKnowledgeDependency.d.ts +46 -0
- package/indexerLayerComposition.d.ts +92 -54
- package/indexerLayoutChange.d.ts +8 -8
- package/indexerLayoutProposalSet.d.ts +15 -10
- package/indexerLayoutResolver.d.ts +15 -6
- package/indexerLayoutTransition.d.ts +8 -8
- package/indexerLifecycle.d.ts +1 -1
- package/indexerMainRunLedger.d.ts +7 -0
- package/indexerMainRunProtocol.d.ts +872 -196
- package/indexerMainWorkset.d.ts +50 -0
- package/indexerNavigationArtifactPlan.d.ts +2 -2
- package/indexerOverlayQuestionAmendment.d.ts +56 -16
- package/indexerOverlayQuestionApplyProposal.d.ts +98 -26
- package/indexerPartitionPlan.d.ts +585 -40
- package/indexerPhysicalArtifactAudit.d.ts +2 -2
- package/indexerPhysicalArtifactManifest.d.ts +24 -24
- package/indexerPostAuthorRunLedger.d.ts +60 -34
- package/indexerPrimaryProjection.d.ts +2 -2
- package/indexerProfileContract.d.ts +28 -28
- package/indexerProgramRunProtocol.d.ts +868 -194
- package/indexerProjectProposal.d.ts +36 -8
- package/indexerProjectedArtifactFanOutAudit.d.ts +2 -2
- package/indexerProvider.d.ts +72 -28
- package/indexerProviderComposition.d.ts +4 -4
- package/indexerProviderRouting.d.ts +52 -0
- package/indexerProviderSelectionProposal.d.ts +48 -0
- package/indexerPublicContractFacts.d.ts +7 -0
- package/indexerPublicContractTable.d.ts +11 -0
- package/indexerReaderTargetInventory.d.ts +6 -6
- package/indexerReferenceOnlyAudit.d.ts +2 -2
- package/indexerRegistry.d.ts +52 -0
- package/indexerRequirementConfirmation.d.ts +48 -16
- package/indexerRequirementLifecycle.d.ts +154 -42
- package/indexerResultReconciliation.d.ts +12 -11
- package/indexerSemanticInput.d.ts +28014 -1847
- package/{indexerGeneratedAuthoringAudit.d.ts → indexerStructuredClaims.d.ts} +0 -84
- package/indexerStructuredDeclaration.d.ts +8 -8
- package/indexerTemplateRendering.d.ts +7 -7
- package/indexerToolSnapshot.d.ts +16 -16
- package/managedSources.d.ts +15 -0
- package/package.json +1 -1
- package/phases.d.ts +0 -3
- package/processedScopes.d.ts +75 -0
- package/readingStructure.d.ts +188 -0
- package/sessionMetadata.d.ts +49 -0
- package/sources.d.ts +9 -3
- package/templates/package-templates/kb/skills/knowledge-query/SKILL.md +15 -10
- package/templates/package-templates.zh-CN/kb/skills/knowledge-query/SKILL.md +8 -8
|
@@ -19,7 +19,7 @@ Approved pages: {{knowledgeCount}}
|
|
|
19
19
|
Values support dotted paths:
|
|
20
20
|
|
|
21
21
|
```md
|
|
22
|
-
{{
|
|
22
|
+
{{buildInventory.package.name}}
|
|
23
23
|
```
|
|
24
24
|
|
|
25
25
|
### Loop
|
|
@@ -102,7 +102,7 @@ Read node_modules/@c4a/context/docs/reference/template-variables.md.
|
|
|
102
102
|
| `skillPath` | string | Final package-relative `SKILL.md` path for the Skill currently being rendered. Empty outside a Skill template. |
|
|
103
103
|
| `knowledgeCount` | number | Selected approved Markdown file count. |
|
|
104
104
|
| `knowledgeTimestamp` | string | Latest selected approved Markdown `timestamp`, or epoch when empty. |
|
|
105
|
-
| `knowledge` | string | Concatenated selected approved
|
|
105
|
+
| `knowledge` | string | Concatenated consumer projection of selected approved pages, with path headings. It omits lifecycle metadata and can be large. |
|
|
106
106
|
| `approvedKnowledge` | string | Alias for `knowledge`. |
|
|
107
107
|
| `knowledgeItems` | array | One record per selected approved Markdown page. |
|
|
108
108
|
| `knowledgeGroups` | array | Selected pages grouped by OKF root and the first directory segment under that root; each item also exposes `internal_collection`. |
|
|
@@ -131,7 +131,7 @@ Each item contains:
|
|
|
131
131
|
|
|
132
132
|
| Field | Meaning |
|
|
133
133
|
|---|---|
|
|
134
|
-
| `path` | Package-relative OKF path, for example `
|
|
134
|
+
| `path` | Package-relative OKF path, for example `guides/architecture/entity/button.md`. |
|
|
135
135
|
| `sourcePath` | Approved knowledge path before OKF output mapping, for example `architecture/entity/button.md`. |
|
|
136
136
|
| `approved_path` | Alias for `sourcePath`. |
|
|
137
137
|
| `dist_path` | Alias for `path`. |
|
|
@@ -142,11 +142,11 @@ Each item contains:
|
|
|
142
142
|
| `okf_root_path` | Final flat package-relative OKF root. |
|
|
143
143
|
| `node_ref` | Stable NodeRef from approved frontmatter, for example `entity/button`. |
|
|
144
144
|
| `view_ref` | Stable ViewRef from approved frontmatter, for example `architecture:entity/button`. |
|
|
145
|
-
| `pathWithinCollection` | Path below the OKF root, for example `
|
|
145
|
+
| `pathWithinCollection` | Path below the OKF root, for example `architecture/entity/button.md`. |
|
|
146
146
|
| `href` | Link relative to the template file currently being rendered. Use this in custom templates. |
|
|
147
147
|
| `hrefFromTemplate` | Alias for `href`. |
|
|
148
|
-
| `hrefFromPackageRoot` | Link from a package-root file such as `AGENTS.md`, for example `./
|
|
149
|
-
| `hrefFromCollectionIndex` | Link from the current OKF root index, for example `./
|
|
148
|
+
| `hrefFromPackageRoot` | Link from a package-root file such as `AGENTS.md`, for example `./guides/architecture/entity/button.md`. |
|
|
149
|
+
| `hrefFromCollectionIndex` | Link from the current OKF root index, for example `./architecture/entity/button.md` for a `guides` item. |
|
|
150
150
|
| `title` | Page title from frontmatter, or a title derived from the file name. |
|
|
151
151
|
| `type` | OKF `type` from frontmatter. |
|
|
152
152
|
| `description` | OKF `description` from frontmatter, when present. |
|
|
@@ -182,7 +182,7 @@ Each group contains:
|
|
|
182
182
|
| `count` | Number of selected pages in this group. |
|
|
183
183
|
| `hasIndex` | Whether the active package navigation policy generates `indexPath`. |
|
|
184
184
|
| `has_index` | Alias for `hasIndex`. |
|
|
185
|
-
| `indexPath` | OKF-root-aware index path, for example `wikis/
|
|
185
|
+
| `indexPath` | OKF-root-aware index path, for example `wikis/codeindex/index.md`, `guides/architecture/index.md`, or `rules/index.md` for a root group. |
|
|
186
186
|
| `indexHrefFromTemplate` | Link from the template file currently being rendered to `indexPath`. Check `hasIndex` before rendering it. |
|
|
187
187
|
| `indexHrefFromCollectionIndex` | Link from the OKF root index to `indexPath`. |
|
|
188
188
|
| `items` | `knowledgeItems` in the group. |
|
package/index.d.ts
CHANGED
|
@@ -137,3 +137,14 @@ export declare const llmsPackage: (definition: {
|
|
|
137
137
|
template: PackageTemplateInput;
|
|
138
138
|
select?: PackageSelectDefinition;
|
|
139
139
|
}) => LlmsPackageDefinition;
|
|
140
|
+
export { projectIndexerPublicContractTable } from "./indexerPublicContractTable.js";
|
|
141
|
+
export { processedScopeSchema, processedScopesSchema, processedScopeKey, readProcessedScopes, mergeProcessedScopes, processedVersionForScope, type ProcessedScope } from "./processedScopes.js";
|
|
142
|
+
export { assertManagedDocumentName, assertManagedDocumentPath, discoverManagedDocuments } from "./managedSources.js";
|
|
143
|
+
export type { ManagedDocumentSourceType, ManagedDocumentSourceEntry } from "./managedSources.js";
|
|
144
|
+
export { sessionChangeSchema, sessionChangesSchema, readSessionChanges, writeSessionChanges } from "./sessionMetadata.js";
|
|
145
|
+
export type { SessionChange } from "./sessionMetadata.js";
|
|
146
|
+
export { indexerArticleKeySchema, indexerArticlePlanSchema, validateIndexerArticlePlan, indexerArticleSectionKey, validateIndexerPlannedArticles } from "./indexerArticlePlan.js";
|
|
147
|
+
export type { IndexerArticlePlan } from "./indexerArticlePlan.js";
|
|
148
|
+
export * from "./readingStructure.js";
|
|
149
|
+
export * from "./indexerKnowledgeDependency.js";
|
|
150
|
+
export * from "./indexerApprovedKnowledge.js";
|