v0.13.0 — umbrella doctor, vault-aware agents, per-session statusline

⚠️ Breaking changes

Old	New
projectstore:projectstore-critic	projectstore:critic
projectstore:code-planner	projectstore:planner (vault-aware: plans against how prior epics map to code via code_refs)
projectstore:code-reviewer	projectstore:reviewer (story-conformance: per-acceptance-criterion evidence)

Migration: update the plugin, /reload-plugins, then run /projectstore:doctor — it names every stale spot in your project (agents block version, frozen model override copies, auto-update flag) with the exact command to fix it. /projectstore:agents register refreshes the CLAUDE.md routing block.

New

• /projectstore:doctor — deterministic, no-LLM diagnostics: installation & wiring (--install, incl. marketplace auto-update + newer-release detection) and vault consistency (--vault); one-line session-start summary, silent when healthy; --fix for approval-gated repairs
• /projectstore:reconcile — rebuild kanban / folder indexes / code-map from frontmatter; hand-edits can never permanently desync anything
• /projectstore:codemap + code_refs — the epic ↔ code mapping (frontmatter is the source of truth; the command is the write path)
• Two new agents — librarian (semantic vault hygiene) and archaeologist (digs undocumented decisions out of existing codebases and proposes backfill ADRs)
• /projectstore:agents — routing block in CLAUDE.md/AGENTS.md + per-project model/effort configuration for all five agents
• Bind v2 — agent registration, model preset, and a status-line offer (with a localized preview) built into first-time setup
• Status line v2 — per-session (parallel sessions never show each other's work), never blank (📚 No epic or story in this session yet / «Эпик и стори ещё не в работе в этой сессии»), [PS#0.13.0] version badge
• Correctness fixes — Russian titles now produce valid unique filenames (transliterating slugify); titles with quotes/colons can't corrupt YAML frontmatter; declining an approval gate leaves the vault byte-for-byte unchanged
• Docs — README rewritten for first-time users (benefit-first, real examples); new how-it-works deep dive; upgrade guide

Design: ADR-001…ADR-006, all peer-reviewed. Full backlog and evaluations live in the project's own projectstore vault — dogfooding all the way down.

v0.12.0 — Status line shows full epic & story titles

The status line now shows the human title: of the current epic and story (from their frontmatter) instead of the folder id / filename slug.

Before: 📚 AUTH-001 › 001-oidc-discovery (in-progress)
After: 📚 Authentication system › OIDC discovery + token exchange (in-progress)

It falls back to the id / filename slug when a title is missing or unreadable, so it never regresses to blank.

Install / upgrade

/plugin marketplace update SmartAndPoint
/reload-plugins

Changelog (since v0.11.0)

• feat: status line shows full epic & story titles + bump to 0.12.0 (#6)

v0.11.0 — Status line: simpler, self-healing install

Refines the v0.10 status line: enabling it is now a single opt-in flag, and the SessionStart hook keeps the wiring pointed at the current plugin version — so it survives plugin updates with no manual path to maintain.

What changed

• One-flag install. /projectstore:statusline on now just sets statusline.enabled in .claude/projectstore.json — no path resolution, no chatty setup. off / status likewise.
• Self-healing. The SessionStart hook writes/refreshes .claude/settings.local.json to the current plugin version's scripts/statusline.mjs on every start — a plugin update no longer leaves a stale, version-baked path.
• Safe by construction. Never clobbers a status line you already set (e.g. oh-my-claudecode); idempotent writes; bails on an unparseable settings file; removes only its own entry on off.

Upgrading from v0.10

If you enabled the status line on v0.10, run /projectstore:statusline on once to adopt the new self-healing wiring (it replaces the old version-baked path).

Install / upgrade

/plugin marketplace update SmartAndPoint
/reload-plugins
/projectstore:statusline on

Changelog (since v0.10.0)

• feat: hook-managed status line install + bump to 0.11.0 (#5)

v0.10.0 — Status line: current epic & story in your HUD

Adds an opt-in status line that shows the epic & story the agent is working on this session — composed above your existing HUD, not replacing it.

What's new in v0.10

• 📚 <epic> › <story> (<status>) in the status line — derived from this session's activity log; it appears once you touch an epic or story, and stays transparent otherwise.
• Composes, doesn't clobber. statusLine is a single slot and not plugin-declarable, so projectstore re-runs whatever base HUD you already have — e.g. oh-my-claudecode, read from ~/.claude/settings.json — prints it verbatim, and adds the 📚 line above it. With no base HUD it renders a standalone line: <model> · <dir> · ⎇ <branch> · 📚 ….
• /projectstore:statusline on | off | status — wires it into the project's .claude/settings.local.json (local scope, this-project-only, reverts cleanly; conventionally git-ignored). Position (above / below) via projectstore.json → statusline.position.

Why compose instead of overwrite

Claude Code exposes a single statusLine slot that a plugin cannot declare. A naive plugin would overwrite whatever HUD you already run. projectstore instead delegates to your existing status line command and augments it — so you keep your full oh-my-claudecode context / rate-limit / session HUD and gain the current epic & story on top. It never touches your global settings.

Robust by design: silent no-op + exit 0 on every failure path; git branch read straight from .git/HEAD (no process spawn); recursion-guarded, timeout-bounded base re-run; EPIPE-guarded output.

Install / upgrade

If you have auto-update enabled for the SmartAndPoint marketplace, v0.10 lands at next Claude Code startup; run /reload-plugins after the notification.

Otherwise:

/plugin marketplace update SmartAndPoint
/reload-plugins

Then enable it in a projectstore-bound project:

/projectstore:statusline on

Changelog (since v0.9.0)

• feat: add status line showing current epic & story + bump to 0.10.0 (#4)

v0.9.0 — Bundled review agents (+ Russian templates)

First minor release since v0.7.1. Headline is three bundled review agents; also rolls up the Russian templates that landed in v0.8.0 but were never cut as a release.

What's new in v0.9 — bundled agents

projectstore now ships three read-only, max-effort Opus subagents under agents/, auto-discovered by the plugin and invokable as projectstore:<name>:

• projectstore-critic — adversarial, fresh-context critic for ADR / research / epic / story artifacts and design proposals. Pre-commits to likely problems, verifies claims against source, runs gap-analysis + pre-mortem. Verdict ship / revise / rethink. /projectstore:review now uses it as its default critic.
• code-planner — pre-implementation planner: where/how a change fits this repo (placement, reuse, conventions, pitfalls, ordered plan).
• code-reviewer — pre-commit reviewer: spec → correctness → regressions → codebase-fit → tests, severity + confidence rated. Verdict commit / fix first.

Plugin agents resolve at the lowest priority, so a same-named agent in ~/.claude/agents/ or .claude/agents/ transparently overrides the bundled one — your own tuned version always wins.

Also rolled up from v0.8.0

• Russian (ru) templates — full ru set (ADR, epic, story, research, runbook, concept, meeting, kanban, folder-readme) alongside the English ones.

Install / upgrade

If you have auto-update enabled for the SmartAndPoint marketplace, v0.9 lands at next Claude Code startup; run /reload-plugins after the notification.

Otherwise:

/plugin marketplace update SmartAndPoint
/reload-plugins

Fresh install:

/plugin marketplace add SmartAndPoint/ProjectStore
/plugin install projectstore@SmartAndPoint
/reload-plugins

Changelog (since v0.7.1)

• feat: bundle review agents (critic/planner/reviewer) + bump to 0.9.0 (#2)
• docs: mark v0.8/v0.9 shipped in README roadmap (#3)
• feat: add Russian (ru) templates + bump to 0.8.0

v0.7.1 — Visible first-run welcome (systemMessage)

Patch release that fixes a UX bug in v0.7.0: the first-run welcome packet was injected into the agent's context but stayed invisible in the terminal, so users restarting Claude Code after install saw nothing.

Fix

SessionStart hook now also emits a one-line `systemMessage` when the welcome fires (same pattern as the v0.6 PreCompact `systemMessage`):

```
👋 projectstore: first-run welcome shown. Start with /projectstore:bind .
See /plugin → Marketplaces to enable auto-update.
```

The full orientation packet still goes to the agent via `additionalContext`. Subsequent sessions are silent (welcome marker tracked at `/.claude/.projectstore-welcomed`).

Upgrade

If you have auto-update enabled, v0.7.1 lands at next Claude Code startup; run `/reload-plugins` after the notification.

Otherwise:

```
/plugin marketplace update SmartAndPoint
/reload-plugins
```

To re-trigger the welcome in a project where you've seen it already:

```
rm /.claude/.projectstore-welcomed
```

Changelog

• `fix: v0.7.1 — SessionStart welcome now visible via systemMessage`
• `docs: swap live star counter for a static "star us" CTA badge`
• `docs: add subtle star nudge in welcome packet + shields.io badges row`
• `chore(marketplace): enrich plugin entry for install UI`

v0.7.0 — First-run welcome + auto-update follow-up

Quality-of-life release: surface the auto-update setting (off by default for third-party marketplaces) at the two natural touchpoints — first session in a project and the `/projectstore:bind` flow.

What's new in v0.7

• First-run welcome — the SessionStart hook detects the first time projectstore loads in a given project and prepends a one-time orientation packet covering: what the plugin does, how to start (`/projectstore:bind`), and how to enable auto-update for the SmartAndPoint marketplace via `/plugin` → Marketplaces. Idempotent: tracked by a marker file at `/.claude/.projectstore-welcomed`.
• `/projectstore:bind` follow-up question — after a successful bind, the command now uses AskUserQuestion to walk the user through enabling auto-update. Answered once per project, tracked by a new `autoupdate_asked: true` field in `projectstore.json`.

Why surfacing this matters

Claude Code does not auto-update third-party plugin marketplaces by default (only official Anthropic ones). Without surfacing this, users would install projectstore and quietly stay on v0.6 forever. The welcome + bind follow-up are pure UX nudges; the actual toggle happens in `/plugin` UI (the plugin cannot flip marketplace settings itself, which is a deliberate Claude Code security boundary).

Install / upgrade

If you have auto-update enabled for `SmartAndPoint` marketplace, v0.7 lands at next Claude Code startup; run `/reload-plugins` after the notification.

Otherwise:

```
/plugin marketplace update SmartAndPoint
/reload-plugins
```

Fresh install:

```
/plugin marketplace add SmartAndPoint/ProjectStore
/plugin install projectstore@SmartAndPoint
/reload-plugins
```

Changelog (since v0.6.0)

• `feat: v0.7.0 — first-run welcome + auto-update follow-up in /projectstore:bind`
• `docs: add Updates section — auto-update default, manual refresh, version pinning`
• `docs: fix README title to match canonical repo name`
• `chore: update repo references after rename to SmartAndPoint/ProjectStore`

v0.6.0 — Session isolation + safer rebind

First public release of projectstore — opinionated project-management paradigms (ADR · epics · stories · kanban · runbooks) as a Claude Code plugin. Agent-maintained Obsidian-friendly markdown vault per project.

What's new in v0.6

• Session isolation — two Claude Code sessions in the same project no longer share a session file. Identity now comes from Claude's own session_id (from the hook stdin input). Legacy .claude/.projectstore-session-id from v0.3 – v0.5 is auto-removed on next SessionStart.
• Visible PreCompact confirmation — the PreCompact hook also emits a one-line systemMessage so you see in /compact stdout that the survival packet was injected (e.g. projectstore: survival packet injected — vault myapp-vault, layout engineering, 3 recent file(s), in-flight: ...).
• Safer /projectstore:bind — when .claude/projectstore.json already exists, the command shows an old → new config diff and asks [Replace / Keep old / Cancel]. Same-vault rebind is a no-op confirmation.
• Idempotent session write — writeSession preserves started_at and recent_activity on re-registration.

What's in the box

• 13 commands · 3 passive skills · 1 layout (engineering) · 9 markdown templates · 3 hooks (SessionStart / PreToolUse / PreCompact).
• An Obsidian-friendly markdown vault per project — agent-maintained, you approve every write. See the README for the framing vs Karpathy's LLM Wiki.

Install

In Claude Code:

```
/plugin marketplace add SmartAndPoint/ProjectStore
/plugin install projectstore@SmartAndPoint
/reload-plugins
```

Bind to a vault:

```
/projectstore:bind ~/Documents/my-project-vault
/projectstore:scaffold engineering
```

Changelog (since v0.5.0)

• `f5c00ba` chore: update repo references after rename to SmartAndPoint/ProjectStore
• `a578ec4` chore(marketplace): add top-level name / owner / description
• `4b2e895` docs: reframe README — Obsidian-vault + Karpathy LLM Wiki positioning, install-first, agent-POV usage
• `dec1052` docs: rewrite README for public release (UTP, multi-session walkthrough, survival packet example)
• `f9ddedc` feat: v0.6.0 — session isolation + safer rebind