feat: npm-managed Python runtime for @kaelio/ktx (#7)

* docs: add npm managed python runtime design

* build: add bundled python runtime wheel builder

* build: make local embedding dependencies optional

* build: bundle python runtime wheel in cli artifacts

* build: track bundled python runtime release artifact

* test: verify bundled python runtime wheel

* docs: add plan for bundled python runtime wheel

* test: cover managed python runtime lifecycle

* feat: add managed python runtime installer

* feat: add runtime command runner

* feat: expose runtime management commands

* test: verify managed python runtime commands

* docs: add plan for managed python runtime installer

* feat: add managed python command helper

* feat: use managed runtime for sl query compute

* feat: route sl query managed runtime policy

* docs: add plan for managed runtime sl query integration

* feat: add managed runtime daemon metadata

* feat: manage python daemon lifecycle

* feat: add runtime daemon start stop commands

* fix: verify managed runtime daemon lifecycle

* docs: add plan for managed runtime daemon lifecycle

* feat: add managed local embeddings config marker

* feat: add managed local embeddings daemon helper

* feat: use managed runtime for local embedding setup

* feat: pass managed runtime policy through setup

* docs: add plan for managed local embeddings runtime

* feat: read CLI package metadata dynamically

* feat: assemble public kaelio ktx npm package

* feat: release one public kaelio ktx npm artifact

* test: cover public kaelio ktx package invocations

* chore: verify public kaelio ktx package artifacts

* docs: add plan for public kaelio ktx npm package

* test: verify managed runtime in public package smoke

* test: finalize managed runtime release smoke

* docs: add plan for managed runtime release smoke

* test: specify local embeddings release smoke

* feat: add local embeddings runtime smoke

* chore: register local embeddings smoke

* fix: verify local embeddings smoke

* fix: restore artifact smoke python env helper

* docs: add plan for managed local embeddings release smoke

* refactor: share managed runtime install policy parsing

* feat: use managed runtime for agent semantic queries

* feat: use managed runtime for MCP semantic compute

* docs: add plan for managed agent and MCP semantic runtime

* feat(cli): add managed daemon HTTP helpers

* feat(cli): route local adapters through managed daemon

* feat(cli): use managed daemon for ingest helpers

* feat(cli): pass managed daemon options to scan

* feat(context): pass MCP ingest pull config options

* feat(cli): pass managed daemon options to serve ingest

* test: verify managed local ingest daemon runtime

* docs: add plan for managed local ingest daemon runtime

* docs: align managed runtime examples

* docs: add plan for managed runtime docs cleanup

* test: cover published package runtime smoke commands

* test: validate published package smoke outputs

* docs: add plan for published package runtime smoke

* build: stamp public npm package version

* release: add npm public release policy

* release: add guarded npm publish script

* release: document public npm release handoff

* docs: add plan for public npm release handoff

* test: cover managed runtime prune in package smoke

* docs: document managed runtime prune

* docs: add plan for managed runtime prune smoke and docs

* chore: encode uv runtime prerequisite policy

* fix: clarify missing uv runtime error

* docs: document uv runtime prerequisite

* docs: add plan for uv runtime prerequisite contract

* refactor: limit release artifacts to public package runtime

* chore: align release policy with bundled runtime wheel

* docs: describe single public runtime artifact surface

* test: verify single public runtime artifact contract

* docs: add plan for single public runtime artifact cleanup

* fix: align local embeddings smoke with public version

* docs: add plan for local embeddings smoke public version

* release: soft-launch as @kaelio/ktx@0.1.0-rc.0 on next tag

Publish target moves to the pre-release version 0.1.0-rc.0 under the next
dist-tag so npm install @kaelio/ktx (which resolves to latest) does not
pick up the soft-launch build. Users opt in via @kaelio/ktx@next.

* Fix release script boundary checks

* Remove PostHog from public package bundle

packages/cli/src/setup.test.ts

@@ -318,6 +318,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -364,6 +365,7 @@ describe('setup status', () => {
           skipAgents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -410,6 +412,7 @@ describe('setup status', () => {
           skipAgents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -434,6 +437,7 @@ describe('setup status', () => {
           skipAgents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -472,6 +476,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -530,6 +535,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -597,6 +603,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -661,6 +668,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -697,6 +705,7 @@ describe('setup status', () => {
           skipAgents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -733,6 +742,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -764,6 +774,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -791,6 +802,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -819,6 +831,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           anthropicApiKeyEnv: 'ANTHROPIC_API_KEY',
           anthropicModel: 'claude-sonnet-4-6',
           skipLlm: false,
@@ -858,7 +871,8 @@ describe('setup status', () => {
           agents: false,
           skipAgents: true,
           inputMode: 'disabled',
-          yes: false,
+          yes: true,
+          cliVersion: '0.2.0',
           anthropicApiKeyEnv: 'ANTHROPIC_API_KEY',
           anthropicModel: 'claude-sonnet-4-6',
           skipLlm: false,
@@ -878,6 +892,8 @@ describe('setup status', () => {
       expect.objectContaining({
         projectDir: tempDir,
         inputMode: 'disabled',
+        cliVersion: '0.2.0',
+        runtimeInstallPolicy: 'auto',
         embeddingBackend: 'openai',
         embeddingApiKeyEnv: 'OPENAI_API_KEY',
         skipEmbeddings: false,
@@ -886,6 +902,43 @@ describe('setup status', () => {
     );
   });
 
+  it('passes no-input runtime policy to the embeddings step', async () => {
+    const io = makeIo();
+    const embeddings = vi.fn(async () => ({ status: 'failed' as const, projectDir: tempDir }));
+
+    await expect(
+      runKtxSetup(
+        {
+          command: 'run',
+          projectDir: tempDir,
+          mode: 'new',
+          agents: false,
+          agentScope: 'project',
+          agentInstallMode: 'cli',
+          skipAgents: true,
+          inputMode: 'disabled',
+          yes: false,
+          cliVersion: '0.2.0',
+          skipLlm: true,
+          skipEmbeddings: false,
+          databaseSchemas: [],
+          skipDatabases: true,
+          skipSources: true,
+        },
+        io.io,
+        { embeddings },
+      ),
+    ).resolves.toBe(1);
+
+    expect(embeddings).toHaveBeenCalledWith(
+      expect.objectContaining({
+        cliVersion: '0.2.0',
+        runtimeInstallPolicy: 'never',
+      }),
+      io.io,
+    );
+  });
+
   it('lets Back from embedding setup return to the model step instead of exiting', async () => {
     const testIo = makeIo();
     const modelResults = [
@@ -905,6 +958,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -952,6 +1006,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           databaseSchemas: [],
@@ -997,6 +1052,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: true,
           databaseSchemas: [],
@@ -1037,6 +1093,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           anthropicApiKeyEnv: 'ANTHROPIC_API_KEY',
           anthropicModel: 'claude-sonnet-4-6',
           skipLlm: false,
@@ -1084,6 +1141,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           skipDatabases: true,
@@ -1130,6 +1188,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           skipDatabases: true,
@@ -1191,6 +1250,7 @@ describe('setup status', () => {
           agentInstallMode: 'cli',
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           skipDatabases: true,
@@ -1244,6 +1304,7 @@ describe('setup status', () => {
           agentInstallMode: 'cli',
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           skipDatabases: true,
@@ -1277,6 +1338,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: true,
           skipEmbeddings: true,
           skipDatabases: true,
@@ -1352,6 +1414,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           skipDatabases: false,
@@ -1416,6 +1479,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           skipDatabases: false,
@@ -1509,6 +1573,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           skipDatabases: false,
@@ -1604,6 +1669,7 @@ describe('setup status', () => {
           agents: false,
           inputMode: 'auto',
           yes: false,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           skipDatabases: false,
@@ -1667,6 +1733,7 @@ describe('setup status', () => {
           agentInstallMode: 'both',
           inputMode: 'disabled',
           yes: true,
+          cliVersion: '0.2.0',
           skipLlm: false,
           skipEmbeddings: false,
           skipDatabases: false,
@@ -1715,6 +1782,7 @@ describe('setup status', () => {
           skipAgents: true,
           inputMode: 'disabled',
           yes: false,
+          cliVersion: '0.2.0',
           anthropicApiKeyEnv: 'ANTHROPIC_API_KEY',
           anthropicModel: 'claude-sonnet-4-6',
           skipLlm: false,