bc-code-intelligence-mcp 1.4.0 → 1.4.2
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/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +86 -43
- package/dist/index.js.map +1 -1
- package/dist/layers/base-layer.d.ts +26 -0
- package/dist/layers/base-layer.d.ts.map +1 -1
- package/dist/layers/base-layer.js +54 -0
- package/dist/layers/base-layer.js.map +1 -1
- package/dist/layers/embedded-layer.d.ts.map +1 -1
- package/dist/layers/embedded-layer.js.map +1 -1
- package/dist/services/multi-content-layer-service.d.ts.map +1 -1
- package/dist/services/multi-content-layer-service.js +36 -15
- package/dist/services/multi-content-layer-service.js.map +1 -1
- package/dist/tools/core-tools.d.ts +26 -0
- package/dist/tools/core-tools.d.ts.map +1 -0
- package/dist/{streamlined-tools.js → tools/core-tools.js} +30 -13
- package/dist/tools/core-tools.js.map +1 -0
- package/dist/tools/handoff-tools.d.ts +37 -0
- package/dist/tools/handoff-tools.d.ts.map +1 -0
- package/dist/tools/handoff-tools.js +265 -0
- package/dist/tools/handoff-tools.js.map +1 -0
- package/dist/tools/index.d.ts +61 -0
- package/dist/tools/index.d.ts.map +1 -0
- package/dist/tools/index.js +75 -0
- package/dist/tools/index.js.map +1 -0
- package/dist/tools/onboarding-tools.d.ts +35 -0
- package/dist/tools/onboarding-tools.d.ts.map +1 -0
- package/dist/tools/onboarding-tools.js +243 -0
- package/dist/tools/onboarding-tools.js.map +1 -0
- package/dist/tools/specialist-tools.d.ts.map +1 -1
- package/dist/tools/specialist-tools.js +6 -1
- package/dist/tools/specialist-tools.js.map +1 -1
- package/dist/types/bc-knowledge.d.ts +8 -8
- package/dist/types/config-types.d.ts +4 -4
- package/dist/types/config-types.d.ts.map +1 -1
- package/dist/types/config-types.js +1 -1
- package/dist/types/config-types.js.map +1 -1
- package/embedded-knowledge/domains/chris-config/knowledge-content-creation.md +437 -0
- package/embedded-knowledge/domains/chris-config/multi-team-layer-configuration.md +302 -0
- package/package.json +8 -11
- package/dist/services/agent-onboarding-service.d.ts +0 -45
- package/dist/services/agent-onboarding-service.d.ts.map +0 -1
- package/dist/services/agent-onboarding-service.js +0 -372
- package/dist/services/agent-onboarding-service.js.map +0 -1
- package/dist/services/specialist-handoff-service.d.ts +0 -85
- package/dist/services/specialist-handoff-service.d.ts.map +0 -1
- package/dist/services/specialist-handoff-service.js +0 -492
- package/dist/services/specialist-handoff-service.js.map +0 -1
- package/dist/streamlined-tools.d.ts +0 -328
- package/dist/streamlined-tools.d.ts.map +0 -1
- package/dist/streamlined-tools.js.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../src/types/config-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,iBAAiB,CAAC;IAG7B,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,oBAAY,eAAe;IACzB,QAAQ,aAAa;
|
|
1
|
+
{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../../src/types/config-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,UAAU,EAAE,kBAAkB,CAAC;IAC/B,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,SAAS,EAAE,iBAAiB,CAAC;IAG7B,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACvC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,oBAAY,eAAe;IACzB,QAAQ,aAAa,CAAG,gBAAgB;IACxC,GAAG,QAAQ,CAAa,gBAAgB;IACxC,KAAK,UAAU,CAAS,gBAAgB;IACxC,IAAI,SAAS,CAAW,4CAA4C;IACpE,GAAG,QAAQ;CACZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,iBAAiB,CAAC;CAC1B;AAED,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,IAAI,EAAE,eAAe,CAAC,GAAG,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oBAAY,QAAQ;IAClB,KAAK,UAAU;IACf,OAAO,QAAQ;IACf,KAAK,UAAU;IACf,KAAK,UAAU;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,GAAG,YAAY,GAAG,WAAW,CAAC;IACrD,mBAAmB,EAAE,eAAe,GAAG,aAAa,GAAG,aAAa,CAAC;IACrE,eAAe,EAAE,OAAO,CAAC;IACzB,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;IACzD,GAAG,EAAE,gBAAgB,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,0BAA0B,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/C,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,wBAAwB,CAAC;IACjC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;IACjC,iBAAiB,EAAE,eAAe,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,YAAY,GAAG,eAAe,GAAG,kBAAkB,GAAG,UAAU,CAAC;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,GAAG,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,eAAe,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,eAAO,MAAM,4BAA4B,EAAE,wBAiE1C,CAAC;AAGF,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;CAgBnB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC"}
|
|
@@ -8,7 +8,7 @@ export var LayerSourceType;
|
|
|
8
8
|
LayerSourceType["GIT"] = "git";
|
|
9
9
|
LayerSourceType["LOCAL"] = "local";
|
|
10
10
|
LayerSourceType["HTTP"] = "http";
|
|
11
|
-
LayerSourceType["NPM"] = "npm";
|
|
11
|
+
LayerSourceType["NPM"] = "npm"; // 🚧 Planned - NPM package knowledge sources
|
|
12
12
|
})(LayerSourceType || (LayerSourceType = {}));
|
|
13
13
|
export var AuthType;
|
|
14
14
|
(function (AuthType) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../src/types/config-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,MAAM,CAAN,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,8BAAW,CAAA;IACX,kCAAe,CAAA;IACf,gCAAa,CAAA;IACb,8BAAW,CAAA;
|
|
1
|
+
{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../../src/types/config-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0BH,MAAM,CAAN,IAAY,eAMX;AAND,WAAY,eAAe;IACzB,wCAAqB,CAAA;IACrB,8BAAW,CAAA;IACX,kCAAe,CAAA;IACf,gCAAa,CAAA;IACb,8BAAW,CAAA,CAAa,6CAA6C;AACvE,CAAC,EANW,eAAe,KAAf,eAAe,QAM1B;AAwCD,MAAM,CAAN,IAAY,QAKX;AALD,WAAY,QAAQ;IAClB,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,2BAAe,CAAA;IACf,2BAAe,CAAA;AACjB,CAAC,EALW,QAAQ,KAAR,QAAQ,QAKnB;AA+GD,iCAAiC;AACjC,MAAM,CAAC,MAAM,4BAA4B,GAA6B;IACpE,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe,CAAC,QAAQ;gBAC9B,IAAI,EAAE,oBAAoB;aAC3B;YACD,OAAO,EAAE,IAAI;SACd;QACD;YACE,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,GAAG;YACb,MAAM,EAAE;gBACN,IAAI,EAAE,eAAe,CAAC,KAAK;gBAC3B,IAAI,EAAE,2BAA2B;aAClC;YACD,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,CAAC,GAAG,CAAC;SAChB;KACF;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,YAAY;QACtB,mBAAmB,EAAE,eAAe;QACpC,eAAe,EAAE,IAAI;QACrB,oBAAoB,EAAE,IAAI;KAC3B;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,UAAU;QACpB,GAAG,EAAE;YACH,GAAG,EAAE,IAAI;YACT,KAAK,EAAE,WAAW;YAClB,IAAI,EAAE,KAAK;YACX,QAAQ,EAAE,WAAW;YACrB,GAAG,EAAE,KAAK;SACX;QACD,WAAW,EAAE,GAAG;QAChB,gBAAgB,EAAE,KAAK;QACvB,kBAAkB,EAAE,IAAI;KACzB;IACD,QAAQ,EAAE;QACR,gBAAgB,EAAE,IAAI;QACtB,iBAAiB,EAAE,IAAI;QACvB,kBAAkB,EAAE,KAAK;QACzB,eAAe,EAAE,EAAE;QACnB,oBAAoB,EAAE,EAAE;QACxB,0BAA0B,EAAE,IAAI;KACjC;IACD,WAAW,EAAE;QACX,oBAAoB,EAAE,CAAC;QACvB,eAAe,EAAE,KAAK;QACtB,UAAU,EAAE,EAAE;QACd,YAAY,EAAE,IAAI;QAClB,gBAAgB,EAAE,IAAI;QACtB,eAAe,EAAE,GAAG;KACrB;IACD,SAAS,EAAE;QACT,YAAY,EAAE,KAAK;QACnB,UAAU,EAAE,KAAK;QACjB,SAAS,EAAE,MAAM;QACjB,mBAAmB,EAAE,KAAK;QAC1B,mBAAmB,EAAE,IAAI;QACzB,oBAAoB,EAAE,KAAK;KAC5B;CACF,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,2BAA2B,EAAE,kBAAkB;IAC/C,4BAA4B,EAAE,wBAAwB;IACtD,0BAA0B,EAAE,sBAAsB;IAClD,yBAAyB,EAAE,qBAAqB;IAChD,8BAA8B,EAAE,gBAAgB;IAChD,6BAA6B,EAAE,eAAe;IAC9C,+BAA+B,EAAE,iBAAiB;IAClD,kCAAkC,EAAE,6BAA6B;IACjE,0BAA0B,EAAE,wBAAwB;IACpD,+BAA+B,EAAE,6BAA6B;IAE9D,wBAAwB;IACxB,qCAAqC,EAAE,4BAA4B;IACnE,uCAAuC,EAAE,4BAA4B;IACrE,wCAAwC,EAAE,+BAA+B;CACjE,CAAC"}
|
|
@@ -0,0 +1,437 @@
|
|
|
1
|
+
---
|
|
2
|
+
title: "Creating Custom BC Knowledge Content"
|
|
3
|
+
domain: "chris-config"
|
|
4
|
+
difficulty: "intermediate"
|
|
5
|
+
bc_versions: "14+"
|
|
6
|
+
tags: ["knowledge-creation", "content-authoring", "yaml-frontmatter", "markdown", "overrides"]
|
|
7
|
+
related_topics: ["multi-team-layer-configuration", "content-quality-standards"]
|
|
8
|
+
applies_to: ["Knowledge Base", "Team Documentation", "Project Customization"]
|
|
9
|
+
last_updated: "2025-01-01"
|
|
10
|
+
---
|
|
11
|
+
|
|
12
|
+
# Creating Custom BC Knowledge Content
|
|
13
|
+
|
|
14
|
+
## Overview
|
|
15
|
+
|
|
16
|
+
Learn to create high-quality BC knowledge content that perfectly fits your organization's needs. This guide covers writing, structuring, and maintaining knowledge overrides that enhance the embedded knowledge base through the layer system.
|
|
17
|
+
|
|
18
|
+
**Key Benefit**: Custom knowledge content allows teams to capture specialized patterns, company standards, and project-specific requirements while maintaining compatibility with the broader BC knowledge ecosystem.
|
|
19
|
+
|
|
20
|
+
## Knowledge Topic Structure
|
|
21
|
+
|
|
22
|
+
Every knowledge topic follows a consistent structure with YAML frontmatter and organized markdown content:
|
|
23
|
+
|
|
24
|
+
```yaml
|
|
25
|
+
---
|
|
26
|
+
# Required Metadata
|
|
27
|
+
title: "Descriptive Topic Title"
|
|
28
|
+
domain: "performance|api-design|security|etc"
|
|
29
|
+
bc_versions: "20+"
|
|
30
|
+
difficulty: "beginner|intermediate|advanced|expert"
|
|
31
|
+
tags: ["tag1", "tag2", "tag3"]
|
|
32
|
+
|
|
33
|
+
# Override Configuration (if applicable)
|
|
34
|
+
overrides: ["embedded-topic-id"]
|
|
35
|
+
merge_strategy: "replace|overlay|smart|append"
|
|
36
|
+
|
|
37
|
+
# Organization Context
|
|
38
|
+
organization_level: "company|team|project"
|
|
39
|
+
author: "your.email@company.com"
|
|
40
|
+
created: "2025-01-15"
|
|
41
|
+
last_modified: "2025-01-20"
|
|
42
|
+
|
|
43
|
+
# Cross-References
|
|
44
|
+
related_topics: ["topic-id-1", "topic-id-2"]
|
|
45
|
+
prerequisites: ["prerequisite-topic-id"]
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
# Topic Title
|
|
49
|
+
|
|
50
|
+
Brief introduction explaining what this topic covers and why it matters.
|
|
51
|
+
|
|
52
|
+
## Overview
|
|
53
|
+
Clear explanation of the concept, pattern, or practice including:
|
|
54
|
+
- What it is and when to use it
|
|
55
|
+
- Why it's important
|
|
56
|
+
- Key benefits for BC development
|
|
57
|
+
|
|
58
|
+
## Business Central Context
|
|
59
|
+
BC-specific considerations:
|
|
60
|
+
- Platform integration points
|
|
61
|
+
- Version compatibility notes
|
|
62
|
+
- Related BC features or modules
|
|
63
|
+
|
|
64
|
+
## Implementation
|
|
65
|
+
Step-by-step guidance with clear instructions:
|
|
66
|
+
|
|
67
|
+
### Prerequisites
|
|
68
|
+
- Required setup or dependencies
|
|
69
|
+
- Assumed knowledge or skills
|
|
70
|
+
|
|
71
|
+
### Step-by-Step Guide
|
|
72
|
+
1. **Step 1**: Detailed instruction
|
|
73
|
+
```al
|
|
74
|
+
// Clear, compilable AL code example
|
|
75
|
+
table 50100 ExampleTable
|
|
76
|
+
{
|
|
77
|
+
DataClassification = CustomerContent;
|
|
78
|
+
|
|
79
|
+
fields
|
|
80
|
+
{
|
|
81
|
+
field(1; "Entry No."; Integer)
|
|
82
|
+
{
|
|
83
|
+
AutoIncrement = true;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
## Best Practices
|
|
90
|
+
Proven recommendations:
|
|
91
|
+
- ✅ Use clear, descriptive naming conventions
|
|
92
|
+
- ✅ Implement proper error handling
|
|
93
|
+
- ✅ Follow BC coding standards
|
|
94
|
+
- ❌ Avoid hard-coded values
|
|
95
|
+
- ❌ Don't skip validation
|
|
96
|
+
|
|
97
|
+
## Version Considerations
|
|
98
|
+
BC version compatibility and migration notes
|
|
99
|
+
|
|
100
|
+
## Troubleshooting
|
|
101
|
+
Common issues and solutions
|
|
102
|
+
|
|
103
|
+
## Related Topics
|
|
104
|
+
Links to related knowledge content
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
## YAML Frontmatter Reference
|
|
108
|
+
|
|
109
|
+
### Required Fields
|
|
110
|
+
```yaml
|
|
111
|
+
---
|
|
112
|
+
title: "Descriptive Topic Title" # Clear, specific title
|
|
113
|
+
domain: "performance" # Domain classification
|
|
114
|
+
bc_versions: "20+" # Version compatibility
|
|
115
|
+
difficulty: "intermediate" # Complexity level
|
|
116
|
+
tags: ["tag1", "tag2"] # Minimum 2 descriptive tags
|
|
117
|
+
---
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
### Domain Classifications
|
|
121
|
+
Choose the most appropriate domain for your content:
|
|
122
|
+
|
|
123
|
+
```yaml
|
|
124
|
+
# Technical domains
|
|
125
|
+
domain: "performance" # Optimization, SIFT, query tuning
|
|
126
|
+
domain: "api-design" # REST, OData, authentication
|
|
127
|
+
domain: "security" # Access control, data protection
|
|
128
|
+
domain: "architecture" # System design, patterns
|
|
129
|
+
domain: "data-architecture" # Tables, relationships
|
|
130
|
+
domain: "debugging" # Troubleshooting, diagnostics
|
|
131
|
+
|
|
132
|
+
# Process domains
|
|
133
|
+
domain: "best-practices" # General guidelines
|
|
134
|
+
domain: "error-handling" # Exception management
|
|
135
|
+
domain: "testing" # Quality assurance
|
|
136
|
+
domain: "deployment" # Release management
|
|
137
|
+
|
|
138
|
+
# Specialist domains
|
|
139
|
+
domain: "alex-architect" # Architecture and design
|
|
140
|
+
domain: "dean-debug" # Performance and debugging
|
|
141
|
+
domain: "sam-coder" # Implementation patterns
|
|
142
|
+
domain: "chris-config" # Configuration and customization
|
|
143
|
+
```
|
|
144
|
+
|
|
145
|
+
### Difficulty Level Guidelines
|
|
146
|
+
```yaml
|
|
147
|
+
difficulty: "beginner" # Basic concepts, getting started
|
|
148
|
+
# - Assumes minimal BC knowledge
|
|
149
|
+
# - Step-by-step instructions
|
|
150
|
+
# - Explains basic concepts
|
|
151
|
+
|
|
152
|
+
difficulty: "intermediate" # Practical implementation
|
|
153
|
+
# - Assumes basic BC development knowledge
|
|
154
|
+
# - Real-world scenarios
|
|
155
|
+
# - Best practices focus
|
|
156
|
+
|
|
157
|
+
difficulty: "advanced" # Complex patterns, optimization
|
|
158
|
+
# - Assumes solid BC experience
|
|
159
|
+
# - Performance considerations
|
|
160
|
+
# - Integration challenges
|
|
161
|
+
|
|
162
|
+
difficulty: "expert" # Cutting-edge, specialized
|
|
163
|
+
# - Assumes deep BC expertise
|
|
164
|
+
# - Advanced patterns
|
|
165
|
+
# - Platform limitations
|
|
166
|
+
```
|
|
167
|
+
|
|
168
|
+
### Effective Tagging Strategy
|
|
169
|
+
```yaml
|
|
170
|
+
# Performance-related tags
|
|
171
|
+
tags: ["sift", "optimization", "query-performance", "memory-management"]
|
|
172
|
+
|
|
173
|
+
# API and integration tags
|
|
174
|
+
tags: ["rest", "odata", "authentication", "integration", "webhooks"]
|
|
175
|
+
|
|
176
|
+
# Architecture and design tags
|
|
177
|
+
tags: ["design-patterns", "microservices", "event-driven", "scalability"]
|
|
178
|
+
|
|
179
|
+
# Development process tags
|
|
180
|
+
tags: ["testing", "debugging", "devops", "code-review"]
|
|
181
|
+
|
|
182
|
+
# Business domain tags
|
|
183
|
+
tags: ["manufacturing", "retail", "financial", "healthcare"]
|
|
184
|
+
```
|
|
185
|
+
|
|
186
|
+
## Override Configuration
|
|
187
|
+
|
|
188
|
+
### Simple Content Override
|
|
189
|
+
Replace embedded content completely:
|
|
190
|
+
```yaml
|
|
191
|
+
---
|
|
192
|
+
title: "Company SIFT Optimization Standards"
|
|
193
|
+
domain: "performance"
|
|
194
|
+
overrides: ["sift-technology-fundamentals"]
|
|
195
|
+
merge_strategy: "replace"
|
|
196
|
+
organization_level: "company"
|
|
197
|
+
---
|
|
198
|
+
```
|
|
199
|
+
|
|
200
|
+
### Content Enhancement
|
|
201
|
+
Add to existing embedded content:
|
|
202
|
+
```yaml
|
|
203
|
+
---
|
|
204
|
+
title: "Team-Specific API Authentication Patterns"
|
|
205
|
+
domain: "api-design"
|
|
206
|
+
overrides: ["api-authentication-patterns"]
|
|
207
|
+
merge_strategy: "append"
|
|
208
|
+
organization_level: "team"
|
|
209
|
+
sections_to_enhance: ["implementation", "examples"]
|
|
210
|
+
---
|
|
211
|
+
```
|
|
212
|
+
|
|
213
|
+
### Conditional Overrides
|
|
214
|
+
Apply overrides based on conditions:
|
|
215
|
+
```yaml
|
|
216
|
+
---
|
|
217
|
+
title: "Production Environment Security Standards"
|
|
218
|
+
domain: "security"
|
|
219
|
+
override_conditions:
|
|
220
|
+
environment: ["production"]
|
|
221
|
+
bc_version: "23+"
|
|
222
|
+
---
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
## Code Example Standards
|
|
226
|
+
|
|
227
|
+
### AL Code Examples
|
|
228
|
+
```al
|
|
229
|
+
// Always include context comments
|
|
230
|
+
table 50100 "Customer Analytics"
|
|
231
|
+
{
|
|
232
|
+
// Purpose: Store customer performance metrics
|
|
233
|
+
DataClassification = CustomerContent;
|
|
234
|
+
|
|
235
|
+
fields
|
|
236
|
+
{
|
|
237
|
+
field(1; "Customer No."; Code[20])
|
|
238
|
+
{
|
|
239
|
+
// Links to standard Customer table
|
|
240
|
+
TableRelation = Customer."No.";
|
|
241
|
+
Caption = 'Customer No.';
|
|
242
|
+
}
|
|
243
|
+
|
|
244
|
+
field(10; "Total Sales Amount"; Decimal)
|
|
245
|
+
{
|
|
246
|
+
// Calculated via SIFT for performance
|
|
247
|
+
FieldClass = FlowField;
|
|
248
|
+
CalcFormula = Sum("Sales Line".Amount WHERE("Sell-to Customer No." = FIELD("Customer No.")));
|
|
249
|
+
Caption = 'Total Sales Amount';
|
|
250
|
+
}
|
|
251
|
+
}
|
|
252
|
+
|
|
253
|
+
keys
|
|
254
|
+
{
|
|
255
|
+
key(PK; "Customer No.")
|
|
256
|
+
{
|
|
257
|
+
Clustered = true;
|
|
258
|
+
}
|
|
259
|
+
|
|
260
|
+
// SIFT key for aggregation performance
|
|
261
|
+
key(SalesAnalysis; "Customer No.")
|
|
262
|
+
{
|
|
263
|
+
SumIndexFields = "Total Sales Amount";
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
}
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
### Configuration Examples
|
|
270
|
+
```json
|
|
271
|
+
// JSON configuration with explanatory comments
|
|
272
|
+
{
|
|
273
|
+
"performance_settings": {
|
|
274
|
+
"enable_sift": true, // Enables SIFT optimization
|
|
275
|
+
"max_records": 10000, // Prevents memory issues
|
|
276
|
+
"timeout_seconds": 30 // Query timeout protection
|
|
277
|
+
},
|
|
278
|
+
"cache_settings": {
|
|
279
|
+
"enabled": true,
|
|
280
|
+
"ttl_minutes": 15 // Cache expiration time
|
|
281
|
+
}
|
|
282
|
+
}
|
|
283
|
+
```
|
|
284
|
+
|
|
285
|
+
## Content Development Workflow
|
|
286
|
+
|
|
287
|
+
### 1. Planning Phase
|
|
288
|
+
```markdown
|
|
289
|
+
## Topic Planning Checklist
|
|
290
|
+
- [ ] Identify knowledge gap or override need
|
|
291
|
+
- [ ] Define target audience and use case
|
|
292
|
+
- [ ] Research existing related topics
|
|
293
|
+
- [ ] Plan topic scope and depth
|
|
294
|
+
- [ ] Choose appropriate domain and tags
|
|
295
|
+
- [ ] Determine BC version compatibility
|
|
296
|
+
```
|
|
297
|
+
|
|
298
|
+
### 2. Content Creation Phase
|
|
299
|
+
```markdown
|
|
300
|
+
## Content Creation Checklist
|
|
301
|
+
- [ ] Write compelling title and overview
|
|
302
|
+
- [ ] Create YAML frontmatter with required fields
|
|
303
|
+
- [ ] Develop step-by-step implementation guide
|
|
304
|
+
- [ ] Include practical, compilable code examples
|
|
305
|
+
- [ ] Add best practices and anti-patterns
|
|
306
|
+
- [ ] Write troubleshooting section
|
|
307
|
+
- [ ] Add cross-references to related topics
|
|
308
|
+
```
|
|
309
|
+
|
|
310
|
+
### 3. Quality Assurance Phase
|
|
311
|
+
```markdown
|
|
312
|
+
## Quality Review Checklist
|
|
313
|
+
- [ ] YAML frontmatter syntax is valid
|
|
314
|
+
- [ ] Markdown renders correctly
|
|
315
|
+
- [ ] Code examples compile successfully
|
|
316
|
+
- [ ] Cross-references resolve correctly
|
|
317
|
+
- [ ] Content accuracy verified
|
|
318
|
+
- [ ] Writing clarity and flow reviewed
|
|
319
|
+
- [ ] Version compatibility confirmed
|
|
320
|
+
```
|
|
321
|
+
|
|
322
|
+
## Layer Integration
|
|
323
|
+
|
|
324
|
+
### Project-Level Overrides
|
|
325
|
+
Create content in your project's override directory:
|
|
326
|
+
```
|
|
327
|
+
bc-code-intel-overrides/
|
|
328
|
+
├── domains/
|
|
329
|
+
│ ├── performance/
|
|
330
|
+
│ │ └── our-sift-standards.md
|
|
331
|
+
│ ├── security/
|
|
332
|
+
│ │ └── company-auth-patterns.md
|
|
333
|
+
│ └── chris-config/
|
|
334
|
+
│ └── project-specific-config.md
|
|
335
|
+
└── specialists/
|
|
336
|
+
└── company-reviewer.md
|
|
337
|
+
```
|
|
338
|
+
|
|
339
|
+
### Team Git Repository
|
|
340
|
+
Structure team knowledge in a Git repository:
|
|
341
|
+
```
|
|
342
|
+
team-bc-knowledge/
|
|
343
|
+
├── domains/
|
|
344
|
+
│ ├── performance/
|
|
345
|
+
│ │ ├── team-optimization-patterns.md
|
|
346
|
+
│ │ └── performance-testing-standards.md
|
|
347
|
+
│ ├── api-design/
|
|
348
|
+
│ │ └── team-integration-patterns.md
|
|
349
|
+
│ └── shared/
|
|
350
|
+
│ └── team-coding-conventions.md
|
|
351
|
+
├── specialists/
|
|
352
|
+
│ └── team-specialist-config.md
|
|
353
|
+
└── methodologies/
|
|
354
|
+
└── team-code-review-process.md
|
|
355
|
+
```
|
|
356
|
+
|
|
357
|
+
### Company Standards Repository
|
|
358
|
+
Maintain organization-wide standards:
|
|
359
|
+
```
|
|
360
|
+
company-bc-standards/
|
|
361
|
+
├── domains/
|
|
362
|
+
│ ├── security/
|
|
363
|
+
│ │ ├── corporate-security-standards.md
|
|
364
|
+
│ │ └── data-classification-requirements.md
|
|
365
|
+
│ ├── architecture/
|
|
366
|
+
│ │ └── enterprise-integration-patterns.md
|
|
367
|
+
│ └── best-practices/
|
|
368
|
+
│ └── corporate-coding-standards.md
|
|
369
|
+
└── policies/
|
|
370
|
+
├── approval-requirements.md
|
|
371
|
+
└── review-processes.md
|
|
372
|
+
```
|
|
373
|
+
|
|
374
|
+
## Quality Standards
|
|
375
|
+
|
|
376
|
+
### Content Quality Metrics
|
|
377
|
+
- **Completeness**: All required sections present
|
|
378
|
+
- **Clarity**: Clear, actionable instructions
|
|
379
|
+
- **Examples**: Working, realistic code samples
|
|
380
|
+
- **Currency**: Up-to-date with current BC versions
|
|
381
|
+
- **Cross-references**: Proper links to related content
|
|
382
|
+
|
|
383
|
+
### Maintenance Standards
|
|
384
|
+
```yaml
|
|
385
|
+
# Quality gates for topic updates
|
|
386
|
+
quality_standards:
|
|
387
|
+
minimum_completeness: 80
|
|
388
|
+
required_sections: ["overview", "implementation", "best-practices"]
|
|
389
|
+
code_example_requirement: true
|
|
390
|
+
cross_reference_minimum: 3
|
|
391
|
+
version_compatibility_current: true
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
## Best Practices
|
|
395
|
+
|
|
396
|
+
### Content Writing
|
|
397
|
+
- **Be specific**: Focus on actionable guidance
|
|
398
|
+
- **Use examples**: Include working AL code samples
|
|
399
|
+
- **Link appropriately**: Reference related topics
|
|
400
|
+
- **Update regularly**: Keep content current with BC versions
|
|
401
|
+
- **Test thoroughly**: Verify all code examples compile
|
|
402
|
+
|
|
403
|
+
### Organization
|
|
404
|
+
- **Consistent structure**: Follow established patterns
|
|
405
|
+
- **Clear taxonomy**: Use appropriate domains and tags
|
|
406
|
+
- **Logical progression**: Order content from basic to advanced
|
|
407
|
+
- **Proper versioning**: Clearly indicate BC compatibility
|
|
408
|
+
|
|
409
|
+
### Collaboration
|
|
410
|
+
- **Document decisions**: Explain why overrides exist
|
|
411
|
+
- **Review processes**: Establish content quality gates
|
|
412
|
+
- **Version control**: Track changes and contributors
|
|
413
|
+
- **Training**: Help team members contribute effectively
|
|
414
|
+
|
|
415
|
+
## Common Anti-Patterns
|
|
416
|
+
|
|
417
|
+
### Content Issues
|
|
418
|
+
- ❌ **Vague titles**: "Performance Tips" instead of specific guidance
|
|
419
|
+
- ❌ **Missing context**: Code without explanation
|
|
420
|
+
- ❌ **Outdated examples**: Using deprecated BC features
|
|
421
|
+
- ❌ **Broken references**: Links to non-existent topics
|
|
422
|
+
|
|
423
|
+
### Organizational Issues
|
|
424
|
+
- ❌ **Too many overrides**: Overriding everything instead of selective enhancement
|
|
425
|
+
- ❌ **Conflicting content**: Multiple teams providing contradictory guidance
|
|
426
|
+
- ❌ **No maintenance**: Creating content without ongoing updates
|
|
427
|
+
- ❌ **Poor governance**: No review or approval processes
|
|
428
|
+
|
|
429
|
+
## Related Topics
|
|
430
|
+
|
|
431
|
+
- **[Multi-Team Layer Configuration](multi-team-layer-configuration)**: Setting up organizational knowledge layers
|
|
432
|
+
- **[Content Quality Standards](content-quality-standards)**: Maintaining high-quality knowledge
|
|
433
|
+
- **[Specialist Customization](specialist-customization)**: Creating custom AI specialists
|
|
434
|
+
|
|
435
|
+
---
|
|
436
|
+
|
|
437
|
+
*Master content creation to build a comprehensive BC knowledge base that serves your organization's specific needs while maintaining compatibility with the broader ecosystem.*
|