V48 (specification-implementation): Clarify jira and kubernetes hierarchy locations

Document that implementations live under packages/externals/jira and
packages/containerizations/kubernetes; keep packages/{jira,kubernetes} as BC
shims only. Align tsconfig, product-naming, and proven path witnesses.

Author: geraldarthurdavis

internal-docs/BITCODE_CONNECTED_SERVICES.md

@@ -30,7 +30,7 @@ Examples:
 
 - `uapi/app/api/vcs/*`
 - `packages/vcs-generics/*` + `packages/generic-vcs/*` (BC: `packages/vcs`, `packages/github`, `packages/gitlab`, `packages/git`, `packages/bitbucket`)
-- `packages/jira/*`
+- `packages/externals/jira/*` (BC `packages/jira`)
 - `packages/external-apps/chatgpt/*`
 - `packages/mcp-generics/* + packages/generic-mcps/bitcode/*`
 - `packages/api/src/routes/*`

packages/containerizations/kubernetes/README.md

@@ -1,4 +1,7 @@
-# @bitcode/kubernetes
+# @bitcode/containerizations-kubernetes
+
+> Path: `packages/containerizations/kubernetes`  
+> BC alias: `@bitcode/kubernetes` (thin re-export at `packages/kubernetes`)
 
 Kubernetes cluster management tools for the Bitcode platform. Provides essential cluster introspection and resource management capabilities.
 
@@ -16,7 +19,8 @@ import {
   kubernetesListPodsTool,
   kubernetesListServicesTool,
   kubernetesDescribeNodeTool 
-} from '@bitcode/kubernetes';
+} from '@bitcode/containerizations-kubernetes';
+// or BC: from '@bitcode/kubernetes'
 
 // List cluster resources
 const pods = await kubernetesListPodsTool();

packages/externals/jira/README.md

@@ -1,4 +1,7 @@
-# @bitcode/jira
+# @bitcode/externals-jira
+
+> Path: `packages/externals/jira`  
+> BC alias: `@bitcode/jira` (thin re-export at `packages/jira`)
 
 Comprehensive Jira integration package for the Bitcode platform. Provides OAuth-authenticated client with full issue management, project operations, and JQL query capabilities.
 
@@ -26,7 +29,8 @@ import {
   createJiraClientFromUser,
   jiraSearchIssues,
   JQL_QUERIES 
-} from '@bitcode/jira';
+} from '@bitcode/externals-jira';
+// or BC: from '@bitcode/jira'
 
 // Create authenticated client
 const client = await createJiraClientFromUser(userId);
@@ -51,7 +55,7 @@ await jiraCreateIssue(
 ## URL Processing
 
 ```typescript
-import { extractIssueKeyFromUrl, parseJiraBaseUrl } from '@bitcode/jira';
+import { extractIssueKeyFromUrl, parseJiraBaseUrl } from '@bitcode/externals-jira';
 
 const issueKey = extractIssueKeyFromUrl(
   'https://company.atlassian.net/browse/PROJ-123'

packages/generic-mcps/bitcode/jest.config.mcp.js

@@ -59,7 +59,7 @@ const explicitMapper = {
   '^@bitcode/sentry$': '<rootDir>/../../../packages/sentry/src/sentry.ts',
   '^@bitcode/streams$': '<rootDir>/../../../packages/api/src/streams/index.ts',
   '^@bitcode/orm$': '<rootDir>/../../../packages/orm/src/index.ts',
-  '^@bitcode/jira-tools$': '<rootDir>/../../../packages/jira/src/index.ts',
+  '^@bitcode/jira-tools$': '<rootDir>/../../../packages/externals/jira/src/index.ts',
   '^@bitcode/pipeline-recovery$': '<rootDir>/src/__stubs__/pipeline-recovery.ts',
   '^@bitcode/generic-mcps-bitcode$': '<rootDir>/src/index.ts',
   '^@bitcode/mcp-server$': '<rootDir>/src/index.ts',

packages/jira/README.md

@@ -0,0 +1,18 @@
+# @bitcode/jira (BC)
+
+**Compatibility re-export.** Full implementation lives at:
+
+```
+packages/externals/jira/   →  @bitcode/externals-jira
+```
+
+```ts
+// Prefer hierarchy name in new code
+import { … } from '@bitcode/externals-jira';
+
+// BC (still supported)
+import { … } from '@bitcode/jira';
+```
+
+Jira Cloud API integration for the Bitcode platform (OAuth client, issues, projects, JQL).
+See `packages/externals/jira/README.md` for the full package surface.

packages/kubernetes/README.md

@@ -0,0 +1,21 @@
+# @bitcode/kubernetes (BC)
+
+**Compatibility re-export.** Full implementation lives at:
+
+```
+packages/containerizations/kubernetes/   →  @bitcode/containerizations-kubernetes
+```
+
+```ts
+// Prefer hierarchy name in new code
+import { … } from '@bitcode/containerizations-kubernetes';
+
+// BC (still supported)
+import { … } from '@bitcode/kubernetes';
+```
+
+Kubernetes cluster management tools for the Bitcode platform. Provides essential
+cluster introspection and resource management capabilities. Designed for
+integration with Bitcode pipeline monitoring and infrastructure management.
+
+See `packages/containerizations/kubernetes/README.md` for the full package surface.

packages/protocol/src/canonical/proven-generator.js

@@ -4810,7 +4810,7 @@ const V26_SYSTEM_REFORM_DECISIONS = [
     livePathRole: 'Jira tooling can contribute admitted integration context without becoming Bitcode Exchange ownership.',
     requiredFiles: [
       'packages/generic-tools/mcps-tools/jira/src/index.ts',
-      'packages/jira/src/index.ts'
+      'packages/externals/jira/src/index.ts'
     ]
   },
   {

protocol-demonstration/src/canonical/proven-generator.js

@@ -4782,7 +4782,7 @@ const V26_SYSTEM_REFORM_DECISIONS = [
     livePathRole: 'Jira tooling can contribute admitted integration context without becoming Bitcode Exchange ownership.',
     requiredFiles: [
       'packages/generic-tools/mcps-tools/jira/src/index.ts',
-      'packages/jira/src/index.ts'
+      'packages/externals/jira/src/index.ts'
     ]
   },
   {

protocol-demonstration/test/v26-active-product-naming.test.js

@@ -383,7 +383,7 @@ const observabilityPackageSource = readFileSync(new URL('../../packages/observab
 const observabilityReadmeSource = readFileSync(new URL('../../packages/observability/README.md', import.meta.url), 'utf8');
 const observabilityJsSource = readFileSync(new URL('../../packages/observability/src/observability.js', import.meta.url), 'utf8');
 const sentryReadmeSource = readFileSync(new URL('../../packages/sentry/README.md', import.meta.url), 'utf8');
-const kubernetesReadmeSource = readFileSync(new URL('../../packages/kubernetes/README.md', import.meta.url), 'utf8');
+const kubernetesReadmeSource = readFileSync(new URL('../../packages/containerizations/kubernetes/README.md', import.meta.url), 'utf8');
 const loggerReadmeSource = readFileSync(new URL('../../packages/logger/README.md', import.meta.url), 'utf8');
 const ormPackageSource = readFileSync(new URL('../../packages/orm/package.json', import.meta.url), 'utf8');
 const ormReadmeSource = readFileSync(new URL('../../packages/orm/README.md', import.meta.url), 'utf8');
@@ -448,7 +448,7 @@ const internalDocsReadmeSource = readFileSync(new URL('../../internal-docs/READM
 const mysqlReadmeSource = readFileSync(new URL('../../packages/mysql/README.md', import.meta.url), 'utf8');
 const authReadmeSource = readFileSync(new URL('../../packages/auth/README.md', import.meta.url), 'utf8');
 const postgresqlReadmeSource = readFileSync(new URL('../../packages/postgresql/README.md', import.meta.url), 'utf8');
-const jiraReadmeSource = readFileSync(new URL('../../packages/jira/README.md', import.meta.url), 'utf8');
+const jiraReadmeSource = readFileSync(new URL('../../packages/externals/jira/README.md', import.meta.url), 'utf8');
 const supabaseReadmeSource = readFileSync(new URL('../../packages/supabase/README.md', import.meta.url), 'utf8');
 const supabaseClientSource = readFileSync(new URL('../../packages/supabase/src/client.ts', import.meta.url), 'utf8');
 const templatesGenericsTypesSource = readFileSync(new URL('../../packages/templates-generics/src/types.ts', import.meta.url), 'utf8');

tsconfig.json

@@ -161,8 +161,10 @@
       "@bitcode/steps": ["packages/pipelines-generics/src/steps/index.ts"],
       "@bitcode/streams": ["packages/streams/src/index.ts"],
       "@bitcode/api/streams": ["packages/api/src/streams/index.ts"],
+      "@bitcode/kubernetes": ["packages/kubernetes/src/index.ts"],
             "@bitcode/containerizations-kubernetes": ["packages/containerizations/kubernetes/src/index.ts"],
             "@bitcode/externals-figma": ["packages/externals/figma/src/index.ts"],
+      "@bitcode/jira": ["packages/jira/src/index.ts"],
             "@bitcode/externals-jira": ["packages/externals/jira/src/index.ts"],
             "@bitcode/externals-notion": ["packages/externals/notion/src/index.ts"],
             "@bitcode/externals-vercel": ["packages/externals/vercel/src/index.ts"],