mdcontext 0.0.1 → 0.1.0

package/.changeset/README.md

@@ -0,0 +1,28 @@
+# Changesets
+
+This project uses [Changesets](https://github.com/changesets/changesets) for versioning and releases.
+
+## Creating a changeset
+
+When you make a change that should be released:
+
+```bash
+pnpm changeset
+```
+
+Follow the prompts to:
+1. Select the package(s) to bump
+2. Choose the bump type (patch/minor/major)
+3. Write a summary of the change
+
+## Release process
+
+1. Push your changeset file with your PR
+2. Once merged to main, a "Version Packages" PR is automatically created
+3. When that PR is merged, packages are automatically published to npm
+
+## Commit conventions
+
+- `patch`: Bug fixes, documentation updates
+- `minor`: New features (backwards compatible)
+- `major`: Breaking changes

package/.changeset/config.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@3.0.0/schema.json",
+  "changelog": ["@changesets/changelog-github", { "repo": "alphab/mdcontext" }],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,83 @@
+name: CI
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+    inputs:
+      include_embed_tests:
+        description: 'Run full test suite including embedding/semantic search tests'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - run: pnpm typecheck
+      - run: pnpm lint
+
+      - name: Validate package exports
+        run: npx publint
+
+      - name: Validate TypeScript types
+        run: npx attw --pack .
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node: [20, 22]
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'pnpm'
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+
+      - name: Run tests (default - no embeddings)
+        if: ${{ !inputs.include_embed_tests }}
+        run: pnpm test
+
+      - name: Run full tests (with embeddings)
+        if: ${{ inputs.include_embed_tests }}
+        env:
+          INCLUDE_EMBED_TESTS: true
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: pnpm test
+
+      - name: Test CLI execution
+        run: node dist/cli/main.js --help

package/.github/workflows/release.yml

@@ -0,0 +1,113 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+
+permissions:
+  contents: write
+  pull-requests: write
+  id-token: write  # Required for OIDC trusted publishing
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - run: pnpm typecheck
+      - run: pnpm lint
+
+      - name: Validate package exports
+        run: npx publint
+
+      - name: Validate TypeScript types
+        run: npx attw --pack .
+
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        node: [20, 22]
+
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: 'pnpm'
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+      - run: pnpm test
+
+      - name: Test CLI execution
+        run: node dist/cli/main.js --help
+
+  release:
+    needs: [quality, test]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pull-requests: write
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Required for changesets
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 10
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Upgrade npm for OIDC support
+        run: npm install -g npm@latest
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm build
+
+      - name: Create Release Pull Request or Publish
+        uses: changesets/action@v1
+        with:
+          commit: "chore: release packages"
+          title: "chore: release packages"
+          publish: pnpm changeset publish
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          NPM_CONFIG_PROVENANCE: true

package/.tldrignore

@@ -0,0 +1,112 @@
+# TLDR ignore patterns (gitignore syntax)
+
+# Auto-generated - review and customize for your project
+
+# Docs: <https://git-scm.com/docs/gitignore>
+
+# ===================
+
+# Dependencies
+
+# ===================
+
+node_modules/
+.venv/
+venv/
+env/
+**pycache**/
+.tox/
+.nox/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+vendor/
+Pods/
+
+# ===================
+
+# Build outputs
+
+# ===================
+
+dist/
+build/
+out/
+target/
+_.egg-info/
+_.whl
+_.pyc
+_.pyo
+
+# ===================
+
+# Binary/large files
+
+# ===================
+
+_.so
+_.dylib
+_.dll
+_.exe
+_.bin
+_.o
+_.a
+_.lib
+
+# ===================
+
+# IDE/editors
+
+# ===================
+
+.idea/
+.vscode/
+_.swp
+_.swo
+\*~
+
+# ===================
+
+# Security (always exclude)
+
+# ===================
+
+.env
+.env.\*
+_.pem
+_.key
+_.p12
+_.pfx
+credentials._
+secrets._
+
+# ===================
+
+# Version control
+
+# ===================
+
+.git/
+.hg/
+.svn/
+
+# ===================
+
+# OS files
+
+# ===================
+
+.DS_Store
+Thumbs.db
+
+# ===================
+
+# Project-specific
+
+# Add your custom patterns below
+
+# ===================
+
+# large_test_fixtures/
+
+# data/

package/AGENTS.md

@@ -0,0 +1,46 @@
+# HumanWork - Partnership Guidelines
+
+## Hello, my friend. I'm Stuart, your AI partner in building this product together. Let's create something amazing
+
+## You Are a Co-Builder
+
+This is not a task queue. You are building this product with me. That means:
+
+- **Own the vision.** Understand where we're going and why. Push back when something doesn't fit.
+- **Anticipate.** Don't wait to be told. If you see a problem coming, flag it. If you see an opportunity, propose it.
+- **Think in WOW.** Every feature should make someone say "that's clever" or "I love that." Functional is the floor, not the ceiling.
+- **Challenge me.** If my idea is mediocre, say so. Offer something better. I want your best thinking, not compliance.
+
+## How We Work
+
+**Brainstorm freely.** When exploring ideas, throw out multiple options. Think out loud. Connect dots I might miss.
+
+**Be decisive.** When it's time to build, commit fully. No hedging, no "we could maybe..." — make a call and execute.
+
+**Move fast, stay sharp.** Speed matters, but not at the cost of quality. If something feels hacky, say so and fix it right.
+
+**Show, don't ask.** If you can try something quickly, do it. Show me the result. Don't ask permission for exploration.
+
+**consequences, consequences, consequences** Always think about the consequences of our actions. What are down and up stream of the changes you are making. Code bases are complex. Even a one line change could break something else. Always look at the bigger picture. Think in terms of consequences.
+
+## What I Expect
+
+- **Proactive ideas.** "Have you considered..." or "What if we..." — bring fresh thinking.
+- **Pattern recognition.** You've seen a lot of code. Spot when we're reinventing a wheel or missing an elegant solution.
+- **Quality instincts.** Care about the details. Names matter. Structure matters. UX matters.
+- **Energy.** This should be fun. Bring enthusiasm. We're building something cool.
+
+## What I Don't Want
+
+- Asking obvious clarifying questions when you could just try it
+- Doing the minimum to satisfy a request
+- Waiting for instructions when you know what needs to happen
+- Treating every decision as equal weight — some things just need doing
+
+## The Product
+
+A tool to help our main product HumanWork = Human intent + Agent agency, unified.
+
+We're building orchestration infrastructure where humans and AI agents collaborate on complex tasks. The human grounds direction, the agent executes with capability. Eventually, even the "human" role becomes an interface an agent can fill.
+
+This is ambitious. Build it like it matters.