Skip to content

docs: rebuild the README on the shared q1k-oss skeleton - #3

Merged
hshekhar-git merged 4 commits into
mainfrom
docs/q1k-oss-readme
Sep 17, 2026
Merged

hshekhar-git merged 4 commits into
mainfrom
docs/q1k-oss-readme

Conversation

@hshekhar-git

Copy link
Copy Markdown
Member

Brings context-engine's README onto the same structure as the other three
q1k-oss packages, and fills in what the repo was missing.

  • Adds the graph mark from the open-source page as .github/logo.svg,
    with a dark-mode variant.
  • Adds a LICENSE file. package.json declared MIT with nothing beside
    it, and had no repository or homepage, so the npm page had no link
    back to the source.
  • Documents the post-ADR-037 surface: the file-upload endpoints are gone,
    and @q1k-oss/context-engine/extraction is listed with the other
    subpaths.
  • Corrects two claims carried over from the old README — engines says
    node >=18, not 20+, and docker-compose.yml brings up a plain
    postgres:16-alpine, not an image with Apache AGE preinstalled.
  • CLAUDE.md keeps its current ADR-037 content, with the internal
    consumer referred to generically since this repo is public.

Docs and metadata only; npm run build passes. No version bump, so the
publish workflow will skip.

🤖 Generated with Claude Code

Same structure as the other three q1k-oss packages, plus the graph mark
from the open-source page with a dark variant.

Corrects two claims: engines says node >=18, not 20+, and
docker-compose brings up a plain postgres:16-alpine, not an image with
Apache AGE already installed.
package.json declared MIT with no LICENSE file alongside it, and had no
repository or homepage, so the npm page had nothing linking back.

CLAUDE.md named an internal consumer and how it vendors this package;
the repo is public, so that is replaced with how the package is meant
to be used.
The README was drafted against 0.2.0. On main the package is a
library first: the file-upload route and its async orchestration are
gone, so their endpoint table is removed, and the new
`@q1k-oss/context-engine/extraction` subpath is documented alongside
the others.

CLAUDE.md keeps its current ADR-037 content, with the internal
consumer named generically — the repo is public.
@hshekhar-git
hshekhar-git merged commit 96d5dd6 into main Sep 17, 2026
1 check passed
@hshekhar-git
hshekhar-git deleted the docs/q1k-oss-readme branch September 17, 2026 23:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant