apunkt/ktx
1
0
Fork 0
mirror of https://github.com/Kaelio/ktx.git synced 2026-06-10 08:05:14 +02:00
Code Issues Projects Releases Packages Wiki Activity
48 commits 228 branches 19 tags 14 MiB
Commit graph

48 commits

This branch
This branch
All branches
Author SHA1 Message Date
Luca Martial
6943f1708d refactor(cli): remove dead demo dep from KtxSetupDeps 
The demo entry menu now calls runDemoTour directly, so the injectable
demo property and KtxDemoArgs import are unused. Update test to mock the
new module import.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 22:03:20 -07:00
Luca Martial
76f727511b fix(cli): correct demo completion summary counts to match manifest 
Hardcoded counts showed 45 semantic layer definitions and 32 knowledge
pages, but the manifest and actual asset files have 46 and 28.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 22:03:12 -07:00
Luca Martial
ebf475e4c1 feat(cli): replace fake demo data with real NBC/Orbit project context 
Replace the placeholder demo assets with real semantic-layer (45 YAML
files) and knowledge (28 markdown files) from the fully-built NBC
project. Update demo tour cards, replay timeline, and completion
summary to reflect real connection names and counts:
- PostgreSQL warehouse: 56 tables across 2 schemas
- dbt: 34 transformation models
- Metabase: 80 dashboard cards
- Notion: 9 knowledge pages
- 45 semantic layer definitions, 32 knowledge pages created

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 21:51:54 -07:00
Luca Martial
c75871bd34 fix(cli): slow demo replay animation to half speed (~6.8s total) 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 16:21:55 -07:00
Luca Martial
6629d69ab4 refactor(cli): rename demo menu option to "Explore a pre-built KTX project" 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 16:13:30 -07:00
Luca Martial
04e9f962af fix(cli): add star headline to demo completion summary per spec 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 15:57:45 -07:00
Luca Martial
8cb6324655 feat(cli): add runDemoTour orchestrator and wire into setup entry menu 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 15:56:44 -07:00
Luca Martial
3677193027 feat(cli): add demo guided tour module with rendering, keypress, and replay 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 15:52:25 -07:00
Luca Martial
e52713ca1e docs: add demo guided tour implementation plan 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 15:26:26 -07:00
Luca Martial
6e2a6b7611 docs: add demo guided tour design spec 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-11 14:34:07 -07:00
Andrey Avtomonov
155613c794
Merge pull request #12 from Kaelio/global-skills-overlay 
fix: link Conductor agent overlays from root checkout
 2026-05-11 20:07:07 +02:00
Andrey Avtomonov
69128ccf72 fix: link Conductor agent overlays from root checkout 2026-05-11 20:06:13 +02:00
Andrey Avtomonov
5a4d8781b5
chore: move docs site workspace (#11) 
* chore: move docs site workspace

* chore: configure docs site deployment
 2026-05-11 18:00:00 +02:00
Andrey Avtomonov
2acaf04f49 chore: configure docs site deployment 2026-05-11 17:57:55 +02:00
Andrey Avtomonov
a46563bb01 chore: move docs site workspace 2026-05-11 16:53:42 +02:00
Andrey Avtomonov
0ae9b6effd
Expose .agents/skills overlay to Claude Code (#10) 
Conductor workspaces symlink `.agents` from KTX_AGENT_OVERLAYS_ROOT, which
Codex CLI reads directly. Claude Code only scans `.claude/skills/`, so the
shared skills were invisible to it. Add `link_agent_skills_for_claude` to
mirror each `.agents/skills/*` entry as a symlink under `.claude/skills/*`.
Idempotent and refuses to clobber existing non-matching entries.
 2026-05-11 16:21:40 +02:00
Andrey Avtomonov
2e10a2d0be
Draft historic-SQL ingestion redesign spec (#8) 
Captures the design for replacing the current per-query, per-dialect
historic-SQL pipeline with a unified, LLM-driven ingest that feeds both
ktx wiki search (pattern pages) and ktx sl search (per-table usage in
_schema shards). Spec covers motivation, principles, architecture, hot
and cold paths, search-surface plumbing, schemas, configuration, cutover
plan, and rejected alternatives.

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-11 16:14:14 +02:00
Andrey Avtomonov
1b84cdd187
Ignore private agent overlay symlinks (#9) 
Co-authored-by: Andrey Avtomonov <7889985+andreybavt@users.noreply.github.com>
 2026-05-11 16:07:17 +02:00
Andrey Avtomonov
1b272c887d Ignore private agent overlay symlinks 2026-05-11 16:05:42 +02:00
Andrey Avtomonov
9dad936ac7
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
 2026-05-11 15:50:34 +02:00
Andrey Avtomonov
075764fe77
[codex] Add Conductor workspace setup (#5) 
* Add Conductor workspace setup

* Refine Conductor setup script structure

* Separate Conductor setup steps

* Consolidate Conductor setup script

* Use KTX env var for agent overlays

* Restore Orbit verification summary docs
 2026-05-11 10:40:30 +02:00
Luca Martial
dc66ffdffb
Merge pull request #6 from Kaelio/luca-martial/fumadocs-cli-docs 
Add Fumadocs documentation site
 2026-05-11 04:11:45 -04:00
Luca Martial
8d6b74f9f5 Merge remote-tracking branch 'origin/main' into luca-martial/fumadocs-cli-docs 
# Conflicts:
#	pnpm-lock.yaml
 2026-05-11 01:10:17 -07:00
Luca Martial
572d515db0 feat(docs): add Fumadocs site workspace 2026-05-11 01:08:31 -07:00
Andrey Avtomonov
76fde89798
[codex] Add Conductor workspace scripts (#2) 
* Add Conductor workspace scripts

* Fix conductor boundary check fixture

* Remove stale frontend conductor guard

* Remove stale app service references

* Optimize relationship discovery benchmarks

* test: move slow suites to ci tier
 2026-05-11 09:55:42 +02:00
Luca Martial
cb9ab25456 docs: add title attributes to config code blocks 
Triggers VS Code tab styling on the docs' YAML/config blocks
where surrounding prose names the file. Mechanical, ~1 edit
across the guides section (building-context.mdx); primary-sources.mdx
and context-sources.mdx already had title= on their Connection config
blocks, so only the prose-named semantic source output example needed
updating.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-11 00:45:43 -07:00
Luca Martial
c54b5ca4cd feat(docs): style Mode B (filename tab) and Mode C (minimal) 
Mode B kicks in when a code block has a title= attribute.
Mode C is the default for unlabeled non-shell blocks: hover
reveals the language label and copy button.

Reduced-motion media query extended to cover the new transitions
and the sidebar chevron rotation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-11 00:42:31 -07:00
Luca Martial
86fc6aa463 feat(docs): style Mode A (terminal) code blocks 
Dark frame in both themes, traffic-light dots, zsh/title label,
copy button in the header. Wizard-glyph content (◆ ◇) also routes
through this mode.
 2026-05-11 00:39:14 -07:00
Luca Martial
cc033f1ce7 feat(docs): wire CodeBlock into MDX components map 
All <pre> elements in docs MDX now render through CodeBlock,
which selects one of three modes based on language and title.
CSS styling for each mode follows.
 2026-05-11 00:37:12 -07:00
Luca Martial
ae1d95a6ce
Merge pull request #4 from Kaelio/luca-martial/connector-credential-paste-ux 
Improve connector credential setup UX
 2026-05-11 03:35:34 -04:00
Luca Martial
3a3dfeeeba feat(docs): add CodeBlock with three context-aware modes 
- Mode A (Terminal): bash/sh languages or wizard-glyph content
- Mode B (VS Code tab): blocks with a title attribute
- Mode C (Minimal): everything else

Component renders only structural markup; CSS for each mode is
added in the following commits.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-11 00:35:14 -07:00
Luca Martial
2f729c9413 Merge remote-tracking branch 'origin/main' into luca-martial/connector-credential-paste-ux 
# Conflicts:
#	packages/cli/src/setup-agents.ts
 2026-05-11 00:34:43 -07:00
Luca Martial
7607e9fd40 feat(docs): add CopyButton component 
Reusable copy-to-clipboard button with animated check on success.
Used by CodeBlock for all three modes.
 2026-05-11 00:33:10 -07:00
Luca Martial
ea2d002a69 fix(docs): tighten sidebar selectors + add focus-visible 
- Scope section trigger rules to div[data-state]:not([class]) so they
  don't bleed onto other Radix collapsibles inside #nd-sidebar.
  Fumadocs 15 section wrapper divs are bare (no class, no id); content
  panels and popovers always carry a class attribute.
- Add focus-visible rings for section buttons and page links
  (a11y gap from code review).
- Add !important to margin-top for consistency with the
  surrounding padding overrides.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 2026-05-11 00:31:58 -07:00
Luca Martial
86c818a454 Normalize semantic layer descriptions 2026-05-11 00:31:15 -07:00
Luca Martial
0049a47cc6 feat(docs): typographic sidebar with active rail 
Uppercase tracked section labels (Outfit, 11px), 1px dividers
between sections, filled-background + 2px primary rail for the
active page. Chevron rotates smoothly on collapse toggle.
Pure CSS — Fumadocs' built-in folder collapsing handles state.
 2026-05-11 00:27:11 -07:00
Luca Martial
399bad0e0b feat(docs): collapse sidebar sections by default 
Activates fumadocs' built-in collapse on every section. Only the
section containing the current page expands; others stay collapsed
until the user clicks them. Foundation for the typographic sidebar
pass in the next commit.
 2026-05-11 00:23:18 -07:00
Luca Martial
c82989119b Update setup and ingest flows 2026-05-10 23:13:17 -07:00
Luca Martial
b3dcb577d9 misc 2026-05-10 20:44:07 -07:00
Luca Martial
549fb35e75 Show progress when watching context builds 2026-05-10 17:08:55 -07:00
Luca Martial
82848e5de9 Watch setup context until terminal status 2026-05-10 16:25:02 -07:00
Luca Martial
440a07d0d2 Summarize connector mapping validation 2026-05-10 16:19:19 -07:00
Luca Martial
1b5a9fe120 Improve connector credential setup UX 2026-05-10 16:12:51 -07:00
Luca Martial
0d35cf8128
Merge pull request #3 from Kaelio/luca-martial/fix-agent-ktx-path 
Pin agent skill and MCP configs to absolute CLI path
 2026-05-10 19:06:29 -04:00
Luca Martial
1a47297e43 pin agent skill and MCP configs to absolute CLI path 
Generated agent skill files and MCP configs previously assumed `ktx`
was on PATH. This resolves the CLI entry point via `import.meta.url`
and `process.execPath` so agents work without any PATH setup.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-05-10 16:01:58 -07:00
Andrey Avtomonov
d89be2390f
Merge pull request #1 from Kaelio/rename-klo-to-ktx 
Rename KLO to KTX
 2026-05-10 23:55:13 +02:00
Andrey Avtomonov
3ce510b55b rename klo to ktx 2026-05-10 23:51:24 +02:00
Andrey Avtomonov
1a42152e6f Initial open-source release 2026-05-10 23:12:26 +02:00