See what your project is actually doing.
Developer observability and verification for Cursor.
+ +**Why a buyer cares:** stackglass packages transferable product IP — source, docs, in-repo brand assets, and a diligence room under `docs/acquisition/` — under a clear proprietary posture so diligence can proceed without mistaking the repo for open source. + +--- + +## 2. Product snapshot | Item | Detail | |------|--------| | Product | stackglass | -| Repository | https://github.com/theworker02/stackglass | -| License type | Proprietary — sale / acquisition / commercial license required | -| Open source? | **No** | +| Repo | `theworker02/stackglass` | +| Language | TypeScript | +| Open source? | **No** — proprietary | | Rightsholder | theworker02 | -| Primary language | TypeScript | +| Diligence pack | `docs/acquisition/` | -## Product +### Capability highlights (from current materials) -Stackglass is the observability and verification layer for AI-assisted development. Cursor writes and reasons about code. Stackglass gives that agent evidence about state, tests, failures, history, configuration, contracts, and documentation ΓÇö so it does not have to guess. +- **GlassCore** workspace runtime, config, process execution, permissions, logging +- **GlassIndex** files, packages, tests, imports, public exports +- **GlassTrace** development timeline +- **GlassWatch** classified file events; optional `watch.autoRun` related tests +- **GlassLab** discovery, plans, runs, flakes, coverage, mutation, contracts +- **GlassLens** narrative, session replay, heat, clusters, snapshot compare, suspicious commits +- **22 MCP tools** plus resources and prompts (new capability is optional args, never a 23rd tool) +- **CLI** `glass` / `stackglass` +- **Cursor plugin** rules, skills, agents, commands, hooks +- **Local dashboard** `glass dashboard` with live Why / Session / Heat / Clusters views --- -## How to purchase or acquire - -1. Contact [@theworker02](https://github.com/theworker02) (or [thanks.dev](https://thanks.dev/u/gh/theworker02)). -2. Describe intended use: seats, deployment model, redistribution / OEM needs, or corporate IP acquisition. -3. Execute NDA if requested for deeper diligence materials. -4. Receive quote and commercial license **or** definitive purchase / asset-transfer terms. -5. Complete payment and closing as agreed; receive entitlement / transfer confirmation. +## 3. Problem / opportunity -Until a paid license or completed acquisition is in place, **do not** deploy this Product commercially, redistribute it, or offer it as a hosted service. +Teams evaluating stackglass typically need either (a) a commercial right to run or embed it, or (b) outright ownership of the Product IP for strategic build-out. Public GitHub visibility without a proprietary license creates false assumptions about free production use. This brief and the linked data room make the commercial path explicit. --- -## Typical commercial structures +## 4. What ships today -| Structure | When it fits | -|-----------|----------------| -| **Commercial license** (non-exclusive) | Run/deploy under seat or deployment terms | -| **Exclusive license** | Field-of-use exclusivity; seller may retain shell entity | -| **Asset / IP sale** | Buyer wants materials and IP assigned outright | -| **OEM / reseller** | Embedding or redistribution — separate agreement | +Honest maturity: treat repository contents, README claims, tests, and release tags as the source of truth. Do not assume production customers, ARR, filed patents, or SLAs unless separately evidenced in diligence. + +Typical transferable surfaces: -Exact pricing, earnouts, and escrow are negotiated under NDA with counsel. **No forged or executed deal docs are implied by this file.** +- Source tree and build/test scripts present in-repo +- Documentation and design notes +- Acquisition / diligence markdown under `docs/acquisition/` +- Branding assets committed to the repository (if any) --- -## What a buyer typically receives +## 5. Demo / evaluation path (buyer) + +Minimal path (no secrets required unless README says otherwise): + +``` +```text +Developer flight recorder ++ Testing laboratory (GlassLab) ++ Change inspector ++ Debugging assistant ++ Project status console ++ MCP server ++ Cursor agent toolkit ++ GlassLens (narrative, session, heat, clusters) +``` +```text +token.ts edited → typecheck fails → two auth tests fail → contract drifts → README example goes stale +``` +```bash +git clone https://github.com/theworker02/stackglass.git +cd stackglass +npm install +npm run build +node cli/dist/bin.js --help +``` +```bash +node /path/to/stackglass/cli/dist/bin.js init +``` +```bash +cd your-project +glass init +glass status +glass why +glass test related +glass dashboard +``` +```bash +glass test related +glass test changed +glass test failed +glass test flakes +glass test repeat 5 +glass test mutation src/auth/token.ts +glass test coverage +glass test contracts +``` + +Extended evaluation: `docs/acquisition/BUYER_EVALUATION.md`. Written NDA / evaluation grants may be required for private materials. -Subject to definitive schedules: +--- -- Repository materials and original Product IP asserted by Rightsholder -- Documentation and diligence artifacts present at closing -- Branding / naming as assigned in the agreement +## 6. What a transaction typically includes + +Subject to definitive schedules: -**Typically excluded unless listed:** seller personal accounts, unrelated repos, third-party dependency source under separate licenses, secrets without a rotation plan, fabricated revenue/user metrics. +| Included (typical) | Excluded (typical) | +|--------------------|--------------------| +| Repo materials + asserted original IP | Seller personal accounts / unrelated repos | +| Docs + diligence room at closing | Third-party dependency source under separate licenses | +| In-repo brand marks as assigned | Secrets without rotation plan | +| Know-how captured in docs | Fabricated revenue, user, or adoption metrics | --- -## Evaluation +## 7. Suggested deal structures -Time-limited evaluation may be offered **in writing only** (often under NDA). Evaluation is non-production unless expressly stated, non-transferable, and does not authorize redistribution or public SaaS hosting. +| Structure | When it fits | +|-----------|--------------| +| Non-exclusive commercial license | Deploy/run under seat or environment terms | +| Exclusive field-of-use license | Buyer wants exclusivity; seller may retain entity | +| Asset / IP assignment | Buyer wants ownership of Materials outright | +| OEM / redistribution | Separate agreement — not implied here | + +Commercial terms (price, earnouts, escrow) are negotiated under NDA with counsel. --- -## Diligence starting checklist (buyer) +## 8. Buyer diligence checklist - [ ] Confirm Rightsholder identity and authority to sell/license -- [ ] Inventory Materials (repo, docs, demos — no secrets without rotation) -- [ ] Implementation maturity: vision vs prototype vs production-ready -- [ ] Third-party OSS / cloud ToS constraints -- [ ] Trademark / domain / naming conflicts -- [ ] Contributor IP assignment chain -- [ ] Post-close LICENSE supersession and public-repo disposition +- [ ] Inventory Materials (`docs/acquisition/ASSET_INVENTORY.md`) +- [ ] Review IP posture (`IP_PROVENANCE.md`) and dependencies (`DEPENDENCY_INVENTORY.md`) +- [ ] Run evaluation script (`BUYER_EVALUATION.md`) +- [ ] Review risks (`RISK_REGISTER.md`) +- [ ] Agree transfer scope (`TRANSFER_MANIFEST.md`) and handoff (`HANDOFF_CHECKLIST.md`) +- [ ] Supersede root `LICENSE` at closing via definitive agreement --- -## Related files +## 9. Related documents | Document | Purpose | |----------|---------| -| `LICENSE` | Proprietary — no default grant until sale/license | -| `.github/FUNDING.yml` | Sponsors / thanks.dev | +| `LICENSE` | Proprietary — no default grant | +| `docs/acquisition/README.md` | Data-room index | +| `docs/acquisition/EXECUTIVE_SUMMARY.md` | One-page thesis | | `README.md` | Product overview | -| `SECURITY.md` | Vulnerability reporting (if present) | -| `acquisition/` or `docs/acquisition/` | Expanded data room (if present) | +| `SECURITY.md` | Vulnerability reporting | +| `COMMERCIAL.md` | Licensing contact path | +| `.github/FUNDING.yml` | Sponsors / thanks.dev | --- -## Disclaimer +## 10. Disclaimer -This document is **informational** and does **not** create a binding offer, grant of rights, or investment advice. Engage counsel for any transaction. +This package is informational and **does not** create a binding offer, grant of rights, or investment advice. Engage counsel for any transaction. --- -*Document version: 1.0.0 / 2026-09-22 · Classification: acquisition briefing* +*Document version: 2.0.0 / 2026-09-22 · Classification: acquisition briefing* diff --git a/README.md b/README.md index bba0b35..73d9f84 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ Stackglass is the **observability and verification layer for AI-assisted development**. -Cursor writes and reasons about code. Stackglass gives that agent evidence about state, tests, failures, history, configuration, contracts, and documentation — so it does not have to guess. +Cursor writes and reasons about code. Stackglass gives that agent evidence about state, tests, failures, history, configuration, contracts, and documentation  so it does not have to guess. It is not another coding assistant. @@ -45,7 +45,7 @@ Agents constantly struggle with questions like: what changed, what is broken, wh Stackglass connects those events. Example: ```text -token.ts edited → typecheck fails → two auth tests fail → contract drifts → README example goes stale +token.ts edited → typecheck fails → two auth tests fail → contract drifts → README example goes stale ``` Ask Cursor _what happened?_ and Stackglass answers with evidence. @@ -274,7 +274,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT. ## License -**Source-available proprietary** — evaluation under [LICENSE](./LICENSE); commercial / production use via [COMMERCIAL.md](./COMMERCIAL.md). See [LICENSE_TRANSITION_NOTICE.md](./LICENSE_TRANSITION_NOTICE.md) and [NOTICE](./NOTICE). +**Source-available proprietary** — evaluation under [LICENSE](./LICENSE); commercial / production use via [COMMERCIAL.md](./COMMERCIAL.md). See [LICENSE_TRANSITION_NOTICE.md](./LICENSE_TRANSITION_NOTICE.md) and [NOTICE](./NOTICE). --- @@ -282,3 +282,7 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT. ## License & acquisition This project is **proprietary**. Production use, redistribution, and commercial deployment require a written commercial license or completed acquisition. See [LICENSE](./LICENSE) and [ACQUISITION.md](./ACQUISITION.md). Contact [@theworker02](https://github.com/theworker02). + +## Acquisition diligence + +Buyer-facing diligence materials live in [docs/acquisition/](./docs/acquisition/). Commercial licensing contact path: [COMMERCIAL.md](./COMMERCIAL.md). diff --git a/SUPPORT.md b/SUPPORT.md new file mode 100644 index 0000000..00bbb7f --- /dev/null +++ b/SUPPORT.md @@ -0,0 +1,13 @@ +# Support — stackglass + +## Community / public + +Public GitHub issues may be used for clarification questions about publicly visible docs. They are **not** a commercial support channel and **not** a deal-negotiation channel. + +## Commercial support + +Licensed customers receive support per their agreement. Acquisition diligence questions: see `ACQUISITION.md` and contact [@theworker02](https://github.com/theworker02). + +## Funding + +[thanks.dev/u/gh/theworker02](https://thanks.dev/u/gh/theworker02) · GitHub Sponsors via `@theworker02` diff --git a/docs/acquisition/ASSET_INVENTORY.md b/docs/acquisition/ASSET_INVENTORY.md new file mode 100644 index 0000000..33d4532 --- /dev/null +++ b/docs/acquisition/ASSET_INVENTORY.md @@ -0,0 +1,33 @@ +# Asset inventory — stackglass + +## Repository surfaces + +| Asset | Location / notes | +|-------|------------------| +| Source tree | Repository root / language packages | +| Tests | `test/`, `tests/`, CI workflows if present | +| Docs | `README.md`, `docs/` | +| Diligence room | `docs/acquisition/` | +| License / notices | `LICENSE`, transition notices if present | +| Funding | `.github/FUNDING.yml` | +| CI | `.github/workflows/` if present | +| Branding | logos/assets folders if present | + +## Capability highlights + +- **GlassCore** workspace runtime, config, process execution, permissions, logging +- **GlassIndex** files, packages, tests, imports, public exports +- **GlassTrace** development timeline +- **GlassWatch** classified file events; optional `watch.autoRun` related tests +- **GlassLab** discovery, plans, runs, flakes, coverage, mutation, contracts +- **GlassLens** narrative, session replay, heat, clusters, snapshot compare, suspicious commits +- **22 MCP tools** plus resources and prompts (new capability is optional args, never a 23rd tool) +- **CLI** `glass` / `stackglass` +- **Cursor plugin** rules, skills, agents, commands, hooks +- **Local dashboard** `glass dashboard` with live Why / Session / Heat / Clusters views + +## Usually excluded + +Seller personal accounts, unrelated repos, and unreissued registry tokens — unless listed in the definitive agreement. + +*Updated: 2026-09-22* diff --git a/docs/acquisition/BUYER_EVALUATION.md b/docs/acquisition/BUYER_EVALUATION.md new file mode 100644 index 0000000..8dc85bc --- /dev/null +++ b/docs/acquisition/BUYER_EVALUATION.md @@ -0,0 +1,66 @@ +# Buyer evaluation — stackglass + +## Goal + +In 15–45 minutes, verify the Product builds or runs as documented and that proprietary notices are present. + +## Steps + +1. Confirm root `LICENSE` is proprietary and `ACQUISITION.md` exists. +2. Skim `README.md` install/run claims. +3. Execute: + +``` +```text +Developer flight recorder ++ Testing laboratory (GlassLab) ++ Change inspector ++ Debugging assistant ++ Project status console ++ MCP server ++ Cursor agent toolkit ++ GlassLens (narrative, session, heat, clusters) +``` +```text +token.ts edited → typecheck fails → two auth tests fail → contract drifts → README example goes stale +``` +```bash +git clone https://github.com/theworker02/stackglass.git +cd stackglass +npm install +npm run build +node cli/dist/bin.js --help +``` +```bash +node /path/to/stackglass/cli/dist/bin.js init +``` +```bash +cd your-project +glass init +glass status +glass why +glass test related +glass dashboard +``` +```bash +glass test related +glass test changed +glass test failed +glass test flakes +glass test repeat 5 +glass test mutation src/auth/token.ts +glass test coverage +glass test contracts +``` + +4. Run tests if present (`npm test`, `pytest`, `cargo test`, `go test ./...`, etc.). +5. Record README vs observed behavior gaps in workpapers. + +## Pass criteria + +- [ ] Clone succeeds +- [ ] Documented happy path works **or** failure is explained +- [ ] Minimal path needs no surprise secrets +- [ ] License notices intact + +*Updated: 2026-09-22* diff --git a/docs/acquisition/DEPENDENCY_INVENTORY.md b/docs/acquisition/DEPENDENCY_INVENTORY.md new file mode 100644 index 0000000..cab60c7 --- /dev/null +++ b/docs/acquisition/DEPENDENCY_INVENTORY.md @@ -0,0 +1,15 @@ +# Dependency inventory — stackglass + +Inspect manifests present in-repo (`package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, `Gemfile`, etc.). + +| Check | Why | +|-------|-----| +| Copyleft depth | Distribution constraints | +| License compatibility | Buyer's intended model | +| Advisories | CVE exposure in locked versions | +| Abandonware | Post-close maintenance | +| Network/telemetry | Privacy / compliance | + +Generate a real SBOM during diligence; this file is a process aid, not a complete SBOM. Ecosystem: **TypeScript**. + +*Updated: 2026-09-22* diff --git a/docs/acquisition/EXECUTIVE_SUMMARY.md b/docs/acquisition/EXECUTIVE_SUMMARY.md new file mode 100644 index 0000000..893277a --- /dev/null +++ b/docs/acquisition/EXECUTIVE_SUMMARY.md @@ -0,0 +1,27 @@ +# Executive summary — stackglass + +## One paragraph + + See what your project is actually doing.
Developer observability and verification for Cursor.
+ +## Strategic read + +stackglass is proprietary Product IP associated with `theworker02/stackglass`. Acquisition value is the working materials, documentation, and a clear path to either a commercial license or an asset purchase — not an open-source community project. + +## Maturity (honest) + +| Claim | Posture | +|-------|---------| +| Production customers / ARR | Not claimed here — verify separately | +| Filed patents | Not claimed — confirm in diligence | +| Completeness vs README | README + tests are authoritative | +| License | Proprietary; sale/license required | + +## Buyer next step + +1. NDA if private materials are needed +2. Run `BUYER_EVALUATION.md` +3. Review transfer schedules +4. Term sheet / definitive docs with counsel + +*Updated: 2026-09-22* diff --git a/docs/acquisition/HANDOFF_CHECKLIST.md b/docs/acquisition/HANDOFF_CHECKLIST.md new file mode 100644 index 0000000..ba9204d --- /dev/null +++ b/docs/acquisition/HANDOFF_CHECKLIST.md @@ -0,0 +1,28 @@ +# Handoff checklist — stackglass + +## Before closing + +- [ ] Freeze transfer commit/tag +- [ ] Finalize transfer schedules +- [ ] Inventory secrets to rotate +- [ ] Plan package-registry ownership transfer +- [ ] Plan CI secret migration + +## At closing + +- [ ] Execute definitive agreement +- [ ] Funds / escrow per agreement +- [ ] Transfer repo or deliver archive +- [ ] Re-publish packages under buyer as needed +- [ ] Update public license messaging as agreed + +## After closing (30 days) + +- [ ] Rotate credentials +- [ ] Re-run evaluation on buyer infra +- [ ] Update SECURITY.md contact +- [ ] Archive diligence workpapers + +Seller contact: [@theworker02](https://github.com/theworker02) + +*Updated: 2026-09-22* diff --git a/docs/acquisition/IP_PROVENANCE.md b/docs/acquisition/IP_PROVENANCE.md new file mode 100644 index 0000000..28a6711 --- /dev/null +++ b/docs/acquisition/IP_PROVENANCE.md @@ -0,0 +1,14 @@ +# IP provenance — stackglass + +| Topic | Statement | +|-------|-----------| +| Rightsholder | theworker02 (https://github.com/theworker02) | +| Product | stackglass | +| Repo | https://github.com/theworker02/stackglass | +| Default grant | None — see root `LICENSE` | + +Review git history, contributor agreements, and employer assignment issues in diligence. If `LICENSE_TRANSITION_NOTICE.md` exists, prior OSS grants may survive for historical copies already received; current tree copies are proprietary going forward. Dependencies remain under their own licenses. + +No patent filing is asserted by this document. Trademark registration status is UNKNOWN unless evidenced elsewhere. + +*Updated: 2026-09-22* diff --git a/docs/acquisition/README.md b/docs/acquisition/README.md new file mode 100644 index 0000000..33f7c76 --- /dev/null +++ b/docs/acquisition/README.md @@ -0,0 +1,15 @@ +# Acquisition data room — stackglass + +**Classification:** Confidential when private materials are shared under NDA. +**Public repo note:** These files are diligence aids; they do **not** grant commercial rights. See root `LICENSE` and `ACQUISITION.md`. + +## How to navigate + +1. `EXECUTIVE_SUMMARY.md` — thesis and maturity honesty +2. `TRANSFER_MANIFEST.md` + `ASSET_INVENTORY.md` — scope +3. `IP_PROVENANCE.md` + `DEPENDENCY_INVENTORY.md` — IP +4. `BUYER_EVALUATION.md` — prove it boots +5. `RISK_REGISTER.md` — known risks +6. `HANDOFF_CHECKLIST.md` — close / transition + +Contact: [@theworker02](https://github.com/theworker02) diff --git a/docs/acquisition/RISK_REGISTER.md b/docs/acquisition/RISK_REGISTER.md new file mode 100644 index 0000000..cfaee8f --- /dev/null +++ b/docs/acquisition/RISK_REGISTER.md @@ -0,0 +1,14 @@ +# Risk register — stackglass + +| ID | Risk | L | I | Mitigation | +|----|------|---|---|------------| +| R1 | README overclaims | M | H | Run evaluation; read tests | +| R2 | Third-party license conflict | M | H | SBOM + counsel | +| R3 | Contributor assignment gaps | L | H | History + agreements | +| R4 | Secret leakage in git history | L | H | Scan + rotate | +| R5 | Trademark collision | M | M | Clearance search | +| R6 | Key-person dependency | H | M | Handoff SOW | +| R7 | Cloud/platform dependency | M | M | Architecture review | +| R8 | Prior OSS copies circulating | M | M | Transition notice clarity | + +*Updated: 2026-09-22* diff --git a/docs/acquisition/TRANSFER_MANIFEST.md b/docs/acquisition/TRANSFER_MANIFEST.md new file mode 100644 index 0000000..d96e762 --- /dev/null +++ b/docs/acquisition/TRANSFER_MANIFEST.md @@ -0,0 +1,27 @@ +# Transfer manifest — stackglass + +## Schedule A — Included (typical) + +1. Git repository `theworker02/stackglass` (or content transfer) +2. Original Product source/docs as of closing tag +3. `docs/acquisition/` diligence materials +4. In-repo marks created for stackglass +5. Asserted copyright in original works (counsel to confirm) + +## Schedule B — Excluded (typical) + +1. Seller personal accounts +2. Unrelated theworker02 repositories +3. Personal cloud billing accounts +4. Registry credentials (rotate / re-issue) +5. Historical secrets (rotate) + +## Schedule C — License supersession + +Definitive agreement supersedes root `LICENSE` for the buyer to the extent of conflict. Specify public-repo disposition (archive / private / transfer). + +## Schedule D — Transition assistance (optional) + +Docs-only vs time-boxed engineering help — negotiate separately. + +*Updated: 2026-09-22*