feat(index): public library barrel re-exporting CspIndex + types

[amondnet]

Summary

Unit 16 — port of src/semble/__init__.py and src/semble/version.py.

Stitches the documented public surface of @pleaseai/csp:

import { CspIndex, ContentType, type Chunk, type SearchResult } from '@pleaseai/csp'

What's in the barrel

• CspIndex (value) — re-exported from ./indexing/index.ts (Unit 12)
• Chunk, SearchResult, IndexStats, EmbeddingMatrix (types) — from ./types.ts (Unit 1)
• ContentType (value + type) — re-exported with export { } (not export type { }) so the runtime enum object survives verbatimModuleSyntax — listing it under export type would erase the runtime side
• version — from ./version.ts, currently '0.0.0' to match package.json#version

Placeholder stubs for sibling units

Per the unit instructions, this PR adds // TODO placeholder modules so the barrel type-checks and src/index.test.ts can run standalone:

• src/types.ts — minimal stub mirroring Unit 1's ContentType const-object enum + Chunk / SearchResult / IndexStats / EmbeddingMatrix shapes
• src/indexing/index.ts — placeholder CspIndex class that throws eagerly to surface sequencing bugs

Both files are clearly marked with TODO(unit-1) / TODO(unit-12) comments and will be overwritten when those units land.

Tests

bun test src/index.test.ts
 4 pass
 0 fail
 9 expect() calls

Smoke tests verify:

1. The barrel imports without error (catches syntactic regressions / circular value-time imports)
2. csp.version is a non-empty string
3. csp.CspIndex is a function (covers class or factory style)
4. csp.ContentType.Code === 'code' etc. — the lowercase string values are part of the on-disk / CLI contract with semble

Notes for reviewers

• Tests pass against the stubs in this PR. They will continue to pass once Unit 1 (feat/unit-1-types) and Unit 12 (CspIndex implementation) land — the stubs are interface-compatible with the real ports.
• package.json is intentionally untouched per unit instructions.

Source of truth

• semble/__init__.py
• semble/version.py

---

Summary by cubic

Adds a public barrel for @pleaseai/csp that re-exports CspIndex, ContentType, core types, and version to match the documented API. Includes minimal stubs and smoke tests so the surface is stable until Units 1 and 12 land.

• New Features
  • Export CspIndex from ./indexing/index.ts and ContentType (as a value) plus Chunk, SearchResult, IndexStats, EmbeddingMatrix from ./types.ts.
  • Expose version from ./version.ts (0.0.0, mirroring package.json).
  • Add Unit 1 and Unit 12 stubs (constructor/methods throw or reject) to keep the barrel type-safe; add smoke tests for exported names, ContentType runtime values, and version shape.

^{Written for commit 9e56611. Summary will update on new commits.}

[gemini-code-assist]

Code Review

This pull request establishes the public library barrel (src/index.ts) and introduces placeholder stubs for CspIndex (src/indexing/index.ts) and associated types (src/types.ts) to enable isolated type-checking and imports. Additionally, it adds smoke tests (src/index.test.ts) to lock down the public API surface and a version module (src/version.ts). There are no review comments, and I have no feedback to provide.

[cubic-dev-ai]

No issues found across 5 files

Architecture diagram

sequenceDiagram
    participant Consumer as External Consumer
    participant Barrel as src/index.ts (Barrel)
    participant Indexing as src/indexing/index.ts (CspIndex)
    participant Types as src/types.ts (Types)
    participant Version as src/version.ts
    participant Test as src/index.test.ts (Smoke Tests)

    Note over Consumer,Test: Public Library Barrel — Runtime & Type-Space Flow

    Consumer->>Barrel: import { CspIndex, ContentType, version } from '@pleaseai/csp'
    Note over Barrel: Re-exports both values & types

    Barrel->>Indexing: export { CspIndex }
    Note over Indexing: Placeholder stub (throws on construction)
    Indexing-->>Barrel: CspIndex class reference

    Barrel->>Types: export { ContentType } (value)
    Barrel->>Types: export type { Chunk, SearchResult, IndexStats, EmbeddingMatrix }
    Note over Types: Placeholder stubs with const-object enum
    Types-->>Barrel: ContentType runtime object + type aliases

    Barrel->>Version: export { version }
    Note over Version: '0.0.0' literal
    Version-->>Barrel: version string

    Barrel-->>Consumer: Resolved imports (types at compile-time, values at runtime)

    Note over Consumer: Runtime Usage (verified by smoke tests)

    Consumer->>Consumer: typeof csp.version === 'string' && length > 0
    Consumer->>Consumer: typeof csp.CspIndex === 'function'
    Consumer->>Consumer: csp.ContentType.Code === 'code'
    Consumer->>Consumer: csp.ContentType.Docs === 'docs'
    Consumer->>Consumer: csp.ContentType.Config === 'config'

    Note over Test: Smoke tests lock down exported surface

    Test->>Barrel: import * as csp
    Barrel-->>Test: Module namespace object
    Test->>Test: Object.keys(csp) includes CspIndex, ContentType, version
    Test->>Test: version is non-empty string
    Test->>Test: CspIndex is function
    Test->>Test: ContentType enum values match contract

Loading

_{Re-trigger cubic}

[amondnet]

Reviewed both bot reviews; no actionable line comments. The stub modules are intentional placeholders pending Unit 12/Unit 1 PRs.