Prevent inconsistencies between configuration sources of truth (build config, extension manifests, and package metadata) that cause IDE/runtime surprises.
Apply these rules when adding/updating any package/extension:
1) Mirror required build configuration options across comparable packages
Example (tsconfig.json):
{
"extends": "../../../tsconfig.json",
"compilerOptions": {
"declarationMap": true,
"outDir": "dist",
"rootDir": "src"
}
}
2) Make manifest tool exposure explicit
includeTools) so trial/managed paths can’t accidentally expose more than intended later.3) Declare or clearly document required env/config
QWEN_EXTERNAL_CONTEXT_CONFIG), surface that requirement in the extension manifest and/or the trial instructions so failures are actionable.4) Keep version sources in sync
package-lock.json and the workspace package.json versions agree (either bump the package.json or revert the lockfile entry) so the next npm install doesn’t silently rewrite lock state.Net effect: consistent IDE navigation, predictable runtime behavior, and fewer “it works on my machine”/dirty lockfile/version drift issues.