ndomo 0.1.0 → 0.2.1

package/.github/release.yml

@@ -1,30 +0,0 @@
-# Configures GitHub release notes auto-generation
-# See: https://docs.github.com/en/repositories/releasing-projects-on-github/automatically-generated-release-notes
-changelog:
-  exclude:
-    labels:
-      - ignore-for-release
-      - duplicate
-      - invalid
-  categorize:
-    - title: Breaking Changes
-      labels:
-        - breaking-change
-        - breaking
-    - title: 🚀 Features
-      labels:
-        - enhancement
-        - feature
-    - title: 🐛 Bug Fixes
-      labels:
-        - bug
-        - fix
-    - title: 📚 Documentation
-      labels:
-        - documentation
-        - docs
-    - title: 🔧 Maintenance
-      labels:
-        - chore
-        - dependencies
-        - ci

package/.github/workflows/gitleaks.yml

@@ -1,28 +0,0 @@
-# .github/workflows/gitleaks.yml
-# Secret scanning via gitleaks
-name: gitleaks
-
-on:
-  push:
-    branches: [main, develop]
-  pull_request:
-    branches: [main, develop]
-
-permissions:
-  contents: read
-  pull-requests: read
-
-jobs:
-  scan:
-    name: gitleaks scan
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout
-        uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
-
-      - name: Run gitleaks
-        uses: gitleaks/gitleaks-action@ff98106e4c7b2bc287b24eaf42907196329070c7  # v2
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          GITLEAKS_ENABLE_UPLOAD_ARTIFACT: true
-          GITLEAKS_ENABLE_SUMMARY: true

package/.github/workflows/release-please.yml

@@ -1,27 +0,0 @@
-# Copyright 2026 — ndomo-v2 contributors
-# SPDX-License-Identifier: MIT
-#
-# Release-please workflow — automated versioning + GitHub Releases
-# Pinned to v5.0.0 commit SHA (audit MISSING-007 principle).
-# See: https://github.com/googleapis/release-please-action
-
-name: release-please
-
-on:
-  push:
-    branches:
-      - main
-
-permissions:
-  contents: write
-  pull-requests: write
-
-jobs:
-  release-please:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: googleapis/release-please-action@45996ed1f6d02564a971a2fa1b5860e934307cf7 # v5.0.0
-        with:
-          release-type: node
-          package-name: ndomo
-          config-file: release-please-config.json

package/.github/workflows/smoke.yml

@@ -1,29 +0,0 @@
-name: smoke
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  smoke:
-    runs-on: ${{ matrix.os }}
-    strategy:
-      fail-fast: false
-      matrix:
-        os: [ubuntu-latest, ubuntu-24.04, macos-latest]
-        bun-version: ['1.3.14', 'latest']
-    steps:
-      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
-      - uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6  # v2
-        with:
-          bun-version: ${{ matrix.bun-version }}
-          cache: true
-      - run: bun install
-      - name: Security audit (bun audit)
-        run: bun audit --audit-level=high
-      - run: bun run lint
-      - run: bun run typecheck
-      - run: bun test
-      - run: bun run test:smoke

package/.husky/commit-msg

@@ -1 +0,0 @@
-bunx --no -- commitlint --edit ${1}

package/CHANGELOG.md

@@ -1,114 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-### Added
-
-- **Ranger agent** — 4th primary agent (`mode: primary`, `model:
-  minimax/MiniMax-M3`, `temp: 0.3`) for analysis/cartography/onboarding
-  workflows. Read-write guard rails: `edit: deny` for source code,
-  `write: ask`, `bash: ask` with read-only allowlist. Delegates to
-  `scout` / `sage` / `scribe` for mapping and research.
-- **`analyses` table + FTS5** — standalone SQLite table for persisted
-  research output (slug, title, project_path, summary, findings_json,
-  source_plan_id, agent, session_id, archived_at). External-content
-  FTS5 index over `title` + `summary` + `findings_json` with sync
-  triggers. Migration v14.
-- **Analysis CRUD module** (`src/db/analyses.ts`) — `createAnalysis`,
-  `getAnalysis`, `getAnalysisBySlug`, `listAnalyses`, `searchAnalyses`
-  (FTS), `updateAnalysis`, `archiveAnalysis`, `linkAnalysisToPlan`,
-  `unlinkAnalysisFromPlan`. 40 unit tests covering FK validation,
-  FTS sync, soft-delete, and slug uniqueness.
-- **7 analysis tools** registered in the OpenCode plugin:
-  `analysis_create`, `analysis_get`, `analysis_list`,
-  `analysis_search`, `analysis_update`, `analysis_archive`,
-  `analysis_link_plan`.
-- **`ndomo-analyses` CLI** — `list` / `get` / `search` / `archive`
-  subcommands reading from the project-local `.ndomo/state.db`.
-- **Integration test suite** (`tests/integration/ranger-flow.test.ts`)
-  — 13 end-to-end tests covering create→link→search→archive→unlink
-  flows and FK CASCADE behavior on plan deletion.
-
-### Changed
-
-- Updated `docs/agents.md` from 21 agents (3 primaries) to 22 agents
-  (4 primaries), including cross-primary routing table for the new
-  ranger entry point.
-- Routing tables in `foreman.md`, `craftsman.md`, and `warden.md`
-  now list ranger alongside the existing primary peers.
-
-### Fixed
-
-- DB hygiene: enable WAL journal mode, NORMAL synchronous, INCREMENTAL
-  auto_vacuum to prevent unbounded `.ndomo/state.db` growth on long-running
-  installs. Sticky one-time migration per DB on first open after upgrade.
-  New `ndomo vacuum` CLI subcommand (or `bun run src/cli/vacuum.ts`) for
-  manual space reclaim via `PRAGMA incremental_vacuum` + `wal_checkpoint(TRUNCATE)`.
-  WAL sidecars (`*.db-wal`, `*.db-shm`) added to `.gitignore`.
-- Shutdown cleanup: `src/db/shutdown.ts` now tracks every `openDb()` call in
-  a `Set<Database>` so each connection gets `SIGTERM`/`SIGINT`/`beforeExit`
-  cleanup. Replaces the module-level `registered` boolean that silently
-  skipped every call after the first (leaked file handles on hot-reload,
-  CLI tools alongside plugin, smoke tests).
-- Background task retention: `BackgroundDispatcher.finalize(maxAgeMs)` prunes
-  terminal tasks (completed/failed/cancelled) older than the threshold; auto-
-  called from plugin init when row count exceeds `backgroundRetention.softCap`
-  (default 1000). Stops unbounded growth of `background_tasks` on long-running
-  installs.
-- Write-tool lock leaks: replaced raw `Map<string, string>` for active writes
-  with a `FileLock` class that stamps each entry with `setAt` and prunes stale
-  locks via TTL sweep. SDK hook-chain breaks (where `tool.execute.after` never
-  fires) no longer block subsequent writes indefinitely. Admin tool
-  `ndomo_write_unlock` exposed for manual recovery.
-
-## [0.1.0] - 2026-06-20
-
-### Added
-
-- Initial ndomo orchestrator: `routeTask`, `canRunParallel`, and reconciler
-  primitives for multi-agent task dispatch and lifecycle management
-- Multi-agent fleet: `foreman` and `craftsman` primaries plus 19 specialist
-  subagents (scout, scribe, painter, smith, sage, guild, inspector,
-  chronicler, stack-smiths, and warden ops fleet)
-- OpenCode plugin layer with hooks, custom tools, hot-swap support, and
-  frontmatter sync for agent and skill metadata
-- DB module: SQLite-backed plans, tasks, and sessions tables with FTS5 search,
-  migrations v1 through v11, and dual plan system (global state.db +
-  per-project archive)
-- Memory system integration with `opencode-mem` including scoped tags,
-  cross-project retrieval, and project-scoped instincts to prevent
-  cross-project contamination
-- Worktree management under `.slim/worktrees/` for parallel, isolated coding
-  lanes
-- Flexible builder pipeline (v2 + v3-lows) and `craftsman` primary agent with
-  plan_db audit trail and pre-merge critical fixes
-- Curl-based install script with provider picker (ndomo vs stock OpenCode)
-- `reasoning_effort` configuration and bundled skills directory for offline
-  distribution
-- `state.db` CLI with 14 tools and 5 migrations covering plan/task/session
-  CRUD, FTS search, and checkpoint helpers
-
-### Changed
-
-- Biome-formatted source tree across all TypeScript modules
-- Documentation refresh covering DB module, flexible builder primary, and
-  ad-hoc flow spec
-
-### Fixed
-
-- Per-project plan archive: drop the global `~/.ndomo/mem/plans` default in
-  favor of project-local storage
-- Scoped session foreign-key upsert (Issue #1 hybrid) so session rows respect
-  plan scoping rules
-- DB query layer: `getPlan`, `getPlanBySlug`, and `listPlans` now JOIN with
-  `plan_files` so file links ship with every plan read
-- Seven medium-priority `craftsman` fixes shipped alongside the Bun skill
-  bootstrap for the `js-smith` specialist
-
-[Unreleased]: https://github.com/nicosup98/ndomo-v2/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/nicosup98/ndomo-v2/releases/tag/v0.1.0

package/Dockerfile

@@ -1,32 +0,0 @@
-# ndomo — OpenCode multi-agent plugin container image
-# Entry point: bun run src/index.ts
-# Base image pinned to bun version from .bun-version (never use `latest`).
-# Multi-stage build keeps final image lean (distroless, no shell).
-
-# ---- Stage 1: Install dependencies ----
-FROM oven/bun:1.3.14-distroless AS deps
-WORKDIR /app
-
-# Copy package manifests first for layer caching (deps only rebuild when manifests change)
-COPY package.json bun.lock ./
-RUN bun install --frozen-lockfile
-
-# Copy application source, bundled assets, and configuration
-COPY src/ ./src/
-COPY skills/ ./skills/
-COPY agents/ ./agents/
-COPY config/ ./config/
-COPY scripts/ ./scripts/
-COPY bin/ ./bin/
-COPY tools/ ./tools/
-COPY opencode.json tsconfig.json biome.json ./
-
-# ---- Stage 2: Runtime ----
-FROM oven/bun:1.3.14-distroless
-WORKDIR /app
-
-COPY --from=deps /app /app
-
-# Plugins are invoked by the OpenCode host; peer deps provided at runtime.
-# JSON-array form avoids shell dependency (distroless has no shell).
-ENTRYPOINT ["bun", "run", "src/index.ts"]

package/bin/ndomo-analyses.ts

@@ -1,4 +0,0 @@
-#!/usr/bin/env bun
-import { runAnalyses } from "../src/cli/analyses.ts";
-
-runAnalyses(process.argv.slice(2));

package/bin/ndomo-status.ts

@@ -1,4 +0,0 @@
-#!/usr/bin/env bun
-import { runStatus } from "../src/cli/status.ts";
-
-runStatus(process.argv.slice(2));

package/biome.json

@@ -1,57 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/2.5.0/schema.json",
-  "vcs": {
-    "enabled": false,
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "files": {
-    "ignoreUnknown": true,
-    "includes": [
-      "**/src/**/*",
-      "**/scripts/**/*",
-      "**/*.ts",
-      "**/*.json",
-      "!**/.cache",
-      "!**/skills",
-      "!**/node_modules"
-    ]
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space",
-    "indentWidth": 2,
-    "lineWidth": 100,
-    "lineEnding": "lf"
-  },
-  "assist": { "actions": { "source": { "organizeImports": "on" } } },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "preset": "recommended",
-      "correctness": {
-        "noUnusedVariables": "error",
-        "useImportExtensions": "error"
-      },
-      "style": {
-        "noNonNullAssertion": "warn",
-        "useConst": "error",
-        "useTemplate": "error"
-      },
-      "suspicious": {
-        "noExplicitAny": "warn"
-      },
-      "complexity": {
-        "noBannedTypes": "error"
-      }
-    }
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "double",
-      "semicolons": "always",
-      "trailingCommas": "all",
-      "arrowParentheses": "always"
-    }
-  }
-}

package/commitlint.config.js

@@ -1,3 +0,0 @@
-export default {
-  extends: ["@commitlint/config-conventional"],
-};

package/opencode.json

@@ -1,5 +0,0 @@
-{
-  "$schema": "https://opencode.ai/config.json",
-  "plugin": ["ndomo"],
-  "default_agent": "foreman"
-}

package/release-please-config.json

@@ -1,11 +0,0 @@
-{
-  "packages": {
-    ".": {
-      "release-type": "node",
-      "changelog-path": "CHANGELOG.md",
-      "bump-minor-pre-major": true,
-      "bump-patch-for-minor-pre-major": false,
-      "include-component-in-tag": false
-    }
-  }
-}

package/scripts/dev-bust-cache.sh

@@ -1,164 +0,0 @@
-#!/usr/bin/env bash
-# dev-bust-cache.sh — bust Bun transpiler cache for ndomo dev loop
-#
-# Root cause: Bun caches TS modules in ~/.bun/install/cache/ keyed by resolved
-# path. When ndomo is loaded via symlink, the cache key uses the symlink path,
-# so editing source files doesn't invalidate the cache → stale code served.
-#
-# This script:
-#   1. Optionally kills running opencode processes (--kill)
-#   2. Removes Bun cache entries referencing ndomo or src/index.ts
-#   3. Touches all src/*.ts to bump mtime (forces re-transpilation)
-#
-# Usage:
-#   ./scripts/dev-bust-cache.sh                  # dry-run (show what would be done)
-#   ./scripts/dev-bust-cache.sh --apply          # actually execute
-#   ./scripts/dev-bust-cache.sh --apply --kill   # kill opencode + bust cache
-#   bun run dev:bust                             # via package.json (dry-run)
-#   bun run dev:reset                            # kill opencode + bust (apply)
-#
-# Idempotent: safe to run multiple times. No-op if cache is already clean.
-
-set -euo pipefail
-
-# ── Colors ────────────────────────────────────────────────────────────────────
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-BOLD='\033[1m'
-NC='\033[0m'
-
-info()  { printf "${BLUE}[info]${NC}  %s\n" "$*"; }
-ok()    { printf "${GREEN}[ok]${NC}    %s\n" "$*"; }
-warn()  { printf "${YELLOW}[warn]${NC}  %s\n" "$*"; }
-err()   { printf "${RED}[error]${NC} %s\n" "$*" >&2; }
-
-# ── Parse flags ───────────────────────────────────────────────────────────────
-APPLY=false
-KILL=false
-
-for arg in "$@"; do
-  case "$arg" in
-    --apply|--force|-f) APPLY=true ;;
-    --kill)             KILL=true ;;
-    --help|-h)
-      cat <<EOF
-${BOLD}dev-bust-cache.sh — bust Bun cache for ndomo dev loop${NC}
-
-Usage:
-  ./scripts/dev-bust-cache.sh [OPTIONS]
-
-Options:
-  --apply    Actually execute (default: dry-run, show what would be done)
-  --kill     Kill running opencode processes before busting
-  --help     Show this help
-
-Without --apply, shows what would be done (dry-run).
-EOF
-      exit 0
-      ;;
-    *) err "Unknown option: $arg (try --help)"; exit 1 ;;
-  esac
-done
-
-# ── Detect project root ───────────────────────────────────────────────────────
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PROJECT_ROOT="$(dirname "$SCRIPT_DIR")"
-SRC_DIR="$PROJECT_ROOT/src"
-
-# ── Bun cache dir ─────────────────────────────────────────────────────────────
-BUN_CACHE="${HOME}/.bun/install/cache"
-
-if [[ ! -d "$BUN_CACHE" ]]; then
-  warn "Bun cache not found at $BUN_CACHE — nothing to bust"
-  exit 0
-fi
-
-# ── Step 1: Kill opencode processes (if --kill) ──────────────────────────────
-if [[ "$KILL" == true ]]; then
-  info "Looking for opencode processes..."
-  PIDS=$(pgrep -f "opencode" 2>/dev/null || true)
-  if [[ -n "$PIDS" ]]; then
-    if [[ "$APPLY" == false ]]; then
-      info "[dry-run] would kill opencode PIDs: ${PIDS//$'\n'/, }"
-    else
-      for pid in $PIDS; do
-        kill "$pid" 2>/dev/null || true
-      done
-      sleep 1
-      ok "Killed opencode processes"
-    fi
-  else
-    info "No opencode processes found"
-  fi
-fi
-
-# ── Step 2: Remove Bun cache entries referencing ndomo ───────────────────────
-info "Searching Bun cache for ndomo references..."
-NDOMO_CACHE_FILES=$(grep -rl "ndomo" "$BUN_CACHE" 2>/dev/null || true)
-
-if [[ -n "$NDOMO_CACHE_FILES" ]]; then
-  COUNT=$(echo "$NDOMO_CACHE_FILES" | wc -l)
-  if [[ "$APPLY" == false ]]; then
-    info "[dry-run] would remove $COUNT cache file(s) referencing ndomo:"
-    echo "$NDOMO_CACHE_FILES" | sed 's/^/  /'
-  else
-    echo "$NDOMO_CACHE_FILES" | while IFS= read -r f; do
-      rm -f "$f"
-    done
-    ok "Removed $COUNT cache file(s) referencing ndomo"
-  fi
-else
-  info "No cache files reference ndomo"
-fi
-
-# ── Step 3: Remove Bun cache entries referencing ndomo source path ───────────
-# Narrow grep to $PROJECT_ROOT/src to avoid matching unrelated packages
-# that happen to have index.ts in their dist files.
-info "Searching Bun cache for ndomo source path references..."
-INDEX_CACHE_FILES=$(grep -rl "$PROJECT_ROOT/src" "$BUN_CACHE" 2>/dev/null || true)
-
-if [[ -n "$INDEX_CACHE_FILES" ]]; then
-  COUNT=$(echo "$INDEX_CACHE_FILES" | wc -l)
-  if [[ "$APPLY" == false ]]; then
-    info "[dry-run] would remove $COUNT cache file(s) referencing $PROJECT_ROOT/src:"
-    echo "$INDEX_CACHE_FILES" | sed 's/^/  /'
-  else
-    echo "$INDEX_CACHE_FILES" | while IFS= read -r f; do
-      rm -f "$f"
-    done
-    ok "Removed $COUNT cache file(s) referencing ndomo source path"
-  fi
-else
-  info "No cache files reference ndomo source path"
-fi
-
-# ── Step 4: Touch all src/*.ts to bump mtime ─────────────────────────────────
-if [[ -d "$SRC_DIR" ]]; then
-  info "Touching src/*.ts files to bump mtime..."
-  TS_FILES=$(find "$SRC_DIR" -name "*.ts" -type f 2>/dev/null || true)
-  if [[ -n "$TS_FILES" ]]; then
-    COUNT=$(echo "$TS_FILES" | wc -l)
-    if [[ "$APPLY" == false ]]; then
-      info "[dry-run] would touch $COUNT .ts file(s) in $SRC_DIR"
-    else
-      echo "$TS_FILES" | while IFS= read -r f; do
-        touch "$f"
-      done
-      ok "Touched $COUNT .ts file(s)"
-    fi
-  else
-    info "No .ts files found in $SRC_DIR"
-  fi
-else
-  warn "src/ directory not found at $SRC_DIR"
-fi
-
-# ── Summary ──────────────────────────────────────────────────────────────────
-echo ""
-if [[ "$APPLY" == false ]]; then
-  warn "DRY RUN — no changes made. Run with --apply to execute."
-else
-  ok "Cache busted. Restart opencode to pick up changes."
-fi