Skip to content

Restructure KnoLo into npm workspace monorepo and add package scaffolds#22

Merged
HiveForensicsAI merged 9 commits intomainfrom
codex/restructure-knolo-repository-for-monorepo
Feb 21, 2026
Merged

Restructure KnoLo into npm workspace monorepo and add package scaffolds#22
HiveForensicsAI merged 9 commits intomainfrom
codex/restructure-knolo-repository-for-monorepo

Conversation

@HiveForensicsAI
Copy link
Contributor

Motivation

  • Provide a clean monorepo layout so core, CLI, adapters, examples, and a create-app template can be developed and published independently.
  • Preserve the existing core implementation and its tests while enabling a quick-adoption, “try in <10 minutes” quickstart-first story.
  • Add minimal scaffolding for adapters and CLI to make future phases focus on implementations rather than repo plumbing.

Description

  • Convert the repository root into an npm workspace (workspaces: ["packages/*"]) and add root scripts build, test, format, and format:check to run across workspaces.
  • Move the existing core sources and scripts into packages/core, update its package.json to @knolo/core (keep version 0.3.1), and ensure dist output and tests remain intact.
  • Create scaffold packages @knolo/cli, @knolo/langchain, and @knolo/llamaindex with placeholder src/index.ts, minimal package.json entries, and no-op build/test scripts.
  • Move the CLI entrypoint to packages/cli/bin/knolo.mjs and update its resolution logic to prefer @knolo/core (with a fallback to the local packages/core/dist); update core test references to the new CLI path.
  • Add placeholders examples/nextjs-rag-chat, examples/node-cli-rag, and templates/create-knolo-app, and refresh the top of README.md to document the new structure and clearly mark implemented vs coming-soon items.

Testing

  • Ran npm install at the repo root and the install completed successfully.
  • Ran npm run build at the repo root and all workspace build scripts executed successfully (core compiled via tsc).
  • Ran npm run test at the repo root and core tests passed after fixing CLI resolution in packages/cli/bin/knolo.mjs and updating packages/core/scripts/test.mjs to call the new CLI path; final test run succeeded.
  • Verified node -e "import('@knolo/core').then(()=>console.log('ok'))" prints ok, confirming ESM workspace import resolution works.

Codex Task

…-cli-for-knolo

feat(cli): productize KnoLo CLI with config-driven workflow
…pp-scaffolder-and-next.js-template

Add create-knolo-app scaffolder with minimal Next.js starter and 5-minute quickstart
…n-and-llamaindex-adapters

Add LangChain & LlamaIndex adapters, runnable examples, and CI smoke tests
…ers-for-create-knolo-app

Harden packaging & smoke tests; clarify adapter compatibility wording
@HiveForensicsAI HiveForensicsAI merged commit bdd24b1 into main Feb 21, 2026
0 of 2 checks passed
@HiveForensicsAI HiveForensicsAI deleted the codex/restructure-knolo-repository-for-monorepo branch February 21, 2026 18:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant