stubborn-watch 0.1.0b1

Dev orchestration: file watch → SCIP indexer → stubborn index --merge

stubborn-watch

Debounced file watch → external SCIP indexer (scip-java) → stubborn index --merge.

Stubborn does not parse Java source. This package only orchestrates the dev loop described in ADR-009.

Install

pip install stubborn-watch

Requires scip-java on PATH for the default indexer command.

Usage

Watch mode (dev loop)

stubborn index --scip index.scip --out symbols.db   # initial full snapshot
stubborn-watch watch --root . --db symbols.db

On save (debounced, default 2s):

1. scip-java index
2. stubborn index --merge for changed relative_path values

One-shot merge (hooks / CI helpers)

stubborn-watch merge-once --root . --db symbols.db \
  --paths com/example/Foo.java,com/example/Bar.java

Use --skip-index when index.scip is already fresh.

Validation scope

This repo owns orchestration-focused validation:

• CLI smoke for merge-once
• debounce and path normalization
• subprocess invocation contracts around scip-java

The canonical ADR-009 runnable demo lives in stubborn-demo:

• stubborn-demo/demo-spring/scripts/run-merge-e2e.ps1

That keeps stubborn-watch focused on watch behavior, while stubborn-demo owns runnable demo assets and black-box validation projects.

Options

Flag	Default	Purpose
--root	.	Project root
--db	(required)	SQLite symbol graph
--scip	index.scip	SCIP index path
--debounce	2.0	Seconds to coalesce events
--pattern	**/*.java	Watched file glob
--scip-cmd	scip-java index	External indexer command

Related

• stubborn — core compiler + --merge
• stubborn-mcp — MCP server over the same symbols.db
• stubborn-demo — runnable demos and validation projects
• stubborn-hub — program architecture

License

MIT — see LICENSE.