@vortex-os/base 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dydan77
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,63 @@
+# @vortex-os/base
+
+Base framework entry point for **VortEX** — a Multi-Agent Personal AI Work OS.
+
+> This is the initial release (0.0.1) and exposes framework metadata only. The full v0.1.0 — which aggregates the framework's modules into a single importable surface — ships in a follow-up cycle. See [phase-10-split-plan.md](https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md) for the capability-cluster packaging design.
+
+## Install
+
+```bash
+npm install @vortex-os/base
+```
+
+## Usage (0.0.1)
+
+```ts
+import { FRAMEWORK_META, VORTEX_BASE_VERSION } from "@vortex-os/base";
+
+console.log(FRAMEWORK_META);
+// {
+//   version: "0.0.1",
+//   framework: "vortex-os",
+//   fullReleaseTarget: "0.1.0",
+//   designReference: "...",
+//   repository: "...",
+// }
+```
+
+## What ships in v0.1.0
+
+`@vortex-os/base` v0.1.0 will re-export the framework's modules as a single package:
+
+- `core` — frontmatter, privacy, types, ModuleContext
+- `slash-commands` — Command, CommandRegistry, runSlash
+- `memory-system` — markdown-frontmatter memory layer
+- `til` — daily work-log store
+- `decision-log` — decision-log store
+- `runbooks` — runbook store
+- `index-generator` — `_INDEX.md` rendering
+- `link-rewriter` — wiki-link detect / resolve / check / rewrite
+- `data-lint` — directory linter
+- `report-generator` — HTML reports with privacy filtering
+- `ai-coding-pitfalls` — coding pitfall catalog
+- `tool-rules` — tool usage rules catalog
+- `session-rituals` plugin — `/session-start`, `/reindex`, `/decision`, `/til`, `/vortex`
+
+## Capability add-ons (Phase 11+)
+
+Future capability clusters publish as siblings under the `@vortex-os` scope:
+
+- `@vortex-os/memory-extended` (Phase 11) — sqlite + vector + recall for scale + semantic search
+- `@vortex-os/dev-toolkit` (Phase 12) — vibe coding + self-QA + CI/CD assistance
+- `@vortex-os/vision` (Phase 14, under review) — screen context + visual reasoning
+
+Each add-on installs alongside the base and extends what the agent can do without forcing a base upgrade.
+
+## Related
+
+- [VortEX framework](https://github.com/dydan77/vortex) — integration template + current monorepo source
+- [Phase 10 split plan](https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md) — capability-cluster design (revision 2)
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @vortex-os/base — base framework entry point for VortEX.
+ *
+ * This is the initial release (0.0.1). The full v0.1.0 will aggregate the
+ * framework modules (core, slash-commands, til, decision-log, memory-system,
+ * runbooks, data-lint, link-rewriter, index-generator, report-generator,
+ * ai-coding-pitfalls, tool-rules, session-rituals) into a single importable
+ * surface, plus an add-on discovery hook. See
+ * https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md
+ * (Phase 10 split plan v2 — capability-cluster) for the shape.
+ *
+ * Until v0.1.0 lands, this package exposes framework metadata only.
+ */
+export declare const VORTEX_BASE_VERSION: "0.0.1";
+/** Framework metadata available at install time, without pulling in any module. */
+export interface VortexFrameworkMeta {
+    readonly version: string;
+    readonly framework: "vortex-os";
+    readonly fullReleaseTarget: string;
+    readonly designReference: string;
+    readonly repository: string;
+}
+export declare const FRAMEWORK_META: VortexFrameworkMeta;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,mBAAmB,EAAG,OAAgB,CAAC;AAEpD,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,cAAc,EAAE,mBAO5B,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @vortex-os/base — base framework entry point for VortEX.
+ *
+ * This is the initial release (0.0.1). The full v0.1.0 will aggregate the
+ * framework modules (core, slash-commands, til, decision-log, memory-system,
+ * runbooks, data-lint, link-rewriter, index-generator, report-generator,
+ * ai-coding-pitfalls, tool-rules, session-rituals) into a single importable
+ * surface, plus an add-on discovery hook. See
+ * https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md
+ * (Phase 10 split plan v2 — capability-cluster) for the shape.
+ *
+ * Until v0.1.0 lands, this package exposes framework metadata only.
+ */
+export const VORTEX_BASE_VERSION = "0.0.1";
+export const FRAMEWORK_META = {
+    version: VORTEX_BASE_VERSION,
+    framework: "vortex-os",
+    fullReleaseTarget: "0.1.0",
+    designReference: "https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md",
+    repository: "https://github.com/vortex-os-project/base",
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC;AAWpD,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,OAAO,EAAE,mBAAmB;IAC5B,SAAS,EAAE,WAAW;IACtB,iBAAiB,EAAE,OAAO;IAC1B,eAAe,EACb,yEAAyE;IAC3E,UAAU,EAAE,2CAA2C;CACxD,CAAC"}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@vortex-os/base",
+  "version": "0.0.1",
+  "description": "Base framework entry point for VortEX (placeholder — full v0.1.0 ships in a follow-up cycle).",
+  "license": "MIT",
+  "author": "dydan77 <styxii77@nate.com>",
+  "homepage": "https://github.com/vortex-os-project/base#readme",
+  "bugs": {
+    "url": "https://github.com/vortex-os-project/base/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vortex-os-project/base.git"
+  },
+  "keywords": [
+    "vortex",
+    "vortex-os",
+    "framework",
+    "agent",
+    "ai-os",
+    "multi-agent",
+    "personal-knowledge-base"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,33 @@
+/**
+ * @vortex-os/base — base framework entry point for VortEX.
+ *
+ * This is the initial release (0.0.1). The full v0.1.0 will aggregate the
+ * framework modules (core, slash-commands, til, decision-log, memory-system,
+ * runbooks, data-lint, link-rewriter, index-generator, report-generator,
+ * ai-coding-pitfalls, tool-rules, session-rituals) into a single importable
+ * surface, plus an add-on discovery hook. See
+ * https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md
+ * (Phase 10 split plan v2 — capability-cluster) for the shape.
+ *
+ * Until v0.1.0 lands, this package exposes framework metadata only.
+ */
+
+export const VORTEX_BASE_VERSION = "0.0.1" as const;
+
+/** Framework metadata available at install time, without pulling in any module. */
+export interface VortexFrameworkMeta {
+  readonly version: string;
+  readonly framework: "vortex-os";
+  readonly fullReleaseTarget: string;
+  readonly designReference: string;
+  readonly repository: string;
+}
+
+export const FRAMEWORK_META: VortexFrameworkMeta = {
+  version: VORTEX_BASE_VERSION,
+  framework: "vortex-os",
+  fullReleaseTarget: "0.1.0",
+  designReference:
+    "https://github.com/dydan77/vortex/blob/main/docs/phase-10-split-plan.md",
+  repository: "https://github.com/vortex-os-project/base",
+};