oreshnik-cli 0.1.0-alpha

package/CHANGELOG.md

@@ -0,0 +1,57 @@
+# Changelog
+
+## [0.1.0-alpha] — 2026-06-13
+
+### S-ORESHNIK-07: Close fix + Tests
+- Close command no longer fails when no files to commit
+- 5 checkpoint/timeline unit tests added (81 total tests, 10 test files)
+- TaskHistoryEntry schema leniency: operator optional, supports from/to for reassignments
+
+### S-ORESHNIK-06: Dashboard Operators & Locks
+- Per-operator task breakdown (ready/active/done/blocked/pending)
+- Active lock display per project from LockService
+- `--detail` flag for per-task listing with dependencies
+- Task status legend visible in dashboard output
+
+### S-ORESHNIK-05: HeptaCore Validation
+- Holistic multi-project start command with context detection
+- Sprint dependency validation: detects [BLOCKED] sprints, offers blocker resolution
+- Oreshnik installed as dependency in HeptaCore
+- 11 npm scripts migrated to CLI wrappers
+- Canonical docs (central, status board, operator state) created for both repos
+
+### S-ORESHNIK-04: Integration Pipeline
+- Conflict prediction and smart JSON merge
+- Validation gates integration
+
+### S-ORESHNIK-03: Init Command
+- Stack-aware templates (nextjs, vite, astro, monorepo, fullstack, typescript, node)
+- Auto-detection of project name, operator, and stack
+- `--interactive` guided setup mode
+- Stack-specific zone maps and validation gates
+
+### S-ORESHNIK-02: Distributed Locks
+- Zone locks via atomic git tags (`oreshnik-lock/*`)
+- TTL-based auto-expiration (default 3600s)
+- Lock check integrated into preflight step 4
+- `oreshnik lock --acquire|--release|--status`
+
+### S-ORESHNIK-01: Core Engine
+- Git-native sprint management engine
+- Result types, Zod schemas, CLI with Commander
+- Portfolio service, injection service, ingestion service
+- Evidence gates, canonical alignment, vault guard
+- Zone engine, audit, rollback, timeline, checkpoints
+
+### MT-01 to MT-10: Multi-Tenant
+- Portfolio management across 6 projects (Oreshnik, HeptaCore, TurpialSound, TurpialMarket, DropSocial, SMSMantis)
+- Meeting notes ingestion → classification → task injection
+- Bootstrap, dashboard, zone-check, audit, secret scan
+- HeptaCore integration with task distribution (Jean, Manuel, Architect)
+
+### Foundation
+- TypeScript CLI with tsup build
+- Vitest test suite
+- `npm run typecheck`, `npm run build`, `npm run test`
+- CRLF/LF consistency, BOM handling
+- Shell:true for Windows .cmd compatibility

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Oreshnik Team
+
+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,126 @@
+# Oreshnik
+
+**Git-native sprint management system — CLI-first, dashboard-optional.**
+
+[![npm version](https://img.shields.io/npm/v/oreshnik)](https://www.npmjs.com/package/oreshnik)
+[![License: MIT](https://img.shields.io/badge/License-MIT-purple.svg)](LICENSE)
+[![Node.js >= 20](https://img.shields.io/badge/node-%3E%3D20-green.svg)](https://nodejs.org)
+
+## One command. Zero config.
+
+```bash
+npx oreshnik init
+```
+
+Detects your stack (Next.js, Vite, Astro, monorepo, TypeScript, Node), creates zone-map, task-board, vault, and operator config.
+
+```bash
+npx oreshnik
+```
+
+Interactive start — detects your operator from `git config user.name`, shows your tasks, validates dependencies, and optionally resolves blockers.
+
+---
+
+## Commands
+
+### Core Workflow
+
+| Command | Description |
+|---|---|
+| `oreshnik` | Interactive start: operator detection, sprint selection, blocker resolution |
+| `oreshnik init` | Initialize Oreshnik in current git repo (`--force`, `--template`, `--interactive`) |
+| `oreshnik preflight` | 11-step validation: sync, vault, zone-check, locks, canonical, tasks, secrets, build |
+| `oreshnik close` | Close sprint: validates evidence, runs gates, creates MADRE branch |
+| `oreshnik status` | Show project state, branch, checkpoints |
+
+### Multi-Project
+
+| Command | Description |
+|---|---|
+| `oreshnik portfolio` | Inspect multi-project portfolio configuration |
+| `oreshnik dashboard` | Multi-project dashboard with operator breakdown and lock status (`--detail`, `--json`, `--markdown`) |
+| `oreshnik ingest` | Ingest meeting notes markdown into classified backlog |
+| `oreshnik inject` | Inject classified tasks into project task-boards |
+| `oreshnik bootstrap` | Initialize Oreshnik structure across portfolio projects |
+
+### Validation
+
+| Command | Description |
+|---|---|
+| `oreshnik zone-check` | Validate zone-map compliance across projects |
+| `oreshnik evidence` | Validate task evidence before sprint closure (`--check`) |
+| `oreshnik gate` | Run validation suite (typecheck, build, tests) |
+| `oreshnik audit` | Cross-project audit: git history, checkpoints, secrets |
+
+### Locking & Recovery
+
+| Command | Description |
+|---|---|
+| `oreshnik lock` | Distributed zone locks via git tags (`--acquire`, `--release`, `--status`) |
+| `oreshnik checkpoint` | Create manual checkpoint tag |
+| `oreshnik rollback` | Restore to previous checkpoint |
+| `oreshnik timeline` | Show checkpoint and sprint timeline |
+| `oreshnik integrate` | Merge sprint into main with zone checks |
+
+---
+
+## Architecture
+
+Oreshnik is **Git-native**. All state lives in files tracked by git:
+
+| Artifact | Location |
+|---|---|
+| Task board | `var/oreshnik/task-board.json` |
+| Zone map | `docs/07_handoffs/zone-map.json` |
+| Portfolio | `.oreshnik.portfolio.json` |
+| Config | `.oreshnik.json` |
+| Locks | `refs/tags/oreshnik-lock/*` |
+| Checkpoints | `refs/tags/oreshnik/*` |
+| Vault | `docs/obsidian-vault/` |
+
+**No database. No external service. No cloud dependency.** The source of truth is the git repo.
+
+## Concepts
+
+### Zones
+Filesystem paths controlled by operators. Zone maps define who can modify which files during which sprints. Violations are detected by `zone-check` and surfaced in preflight.
+
+### Locks
+Atomic distributed locks via git tags. When an operator starts a sprint on a zone, they acquire a lock. Other operators see `[LOCK]` warnings in preflight. Locks auto-expire (TTL, default 1 hour).
+
+### Task Board
+A JSON file tracking all tasks: ID, title, owner, status (ready/active/blocked/done/pending), dependencies, acceptance criteria, and history.
+
+### Canonical Docs
+Derived markdown documents regenerated from the task board on each close. Includes central dashboard, operator status files, and status board. Preflight validates they match the task board.
+
+### Evidence Gates
+Tasks marked `done` must have verifiable evidence: file changes, typecheck success, test results. Preflight and close validate this.
+
+## Operators
+
+Multiple operators collaborate on the same repo via git branches:
+
+```
+MADRE/v5-s-oreshnik-07-... → mother branch (source of truth)
+Architect/s-oreshnik-07-... → architect's work branch
+Jean/s-hc-prod-02-...       → Jean's work branch
+Manuel/s-hc-prod-03-...     → Manuel's work branch
+```
+
+Oreshnik detects divergence, backs up local work, and aligns on each session start.
+
+## Install
+
+```bash
+npm install -g oreshnik
+# or
+npx oreshnik init
+```
+
+**Requirements**: Node.js >= 20, git >= 2.30
+
+## License
+
+MIT © 2026 Oreshnik Team

package/dist/cli.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node