Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions .github/dependabot.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ updates:
schedule:
interval: "weekly"
open-pull-requests-limit: 5
ignore:
# Dependabot currently errors on github/codeql-action in this repository.
# Track re-enable work in issue #20 and update the CodeQL action manually meanwhile.
- dependency-name: "github/codeql-action"
labels:
- "dependencies"
- "github-actions"
Expand Down
14 changes: 8 additions & 6 deletions docs/roadmap.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Roadmap

Snapshot date: 2026-03-23
Snapshot date: 2026-03-30

## Current Direction

Expand All @@ -11,6 +11,7 @@ Snapshot date: 2026-03-23
- a first operator-configurable policy slice now exists through versioned TOML
- standard-client MCP validation now exists through the official Inspector CLI
- approval concurrency now deduplicates active envelopes and blocks duplicate in-flight execution
- the public repository baseline now includes Apache-2.0 licensing, governance docs, working `pre-commit`, Bandit, Dependabot, and protected `main` status checks
- current priority is to mature the runtime and MCP path into a trustworthy operational interface

## Phase 1: Controlled MCP Write Path
Expand Down Expand Up @@ -85,11 +86,12 @@ Exit criteria:

## Near-Term Execution Order

1. define tool-schema compatibility rules and release policy
2. continue core/interface cleanup
3. add container-backed service/config integration harnesses
4. broaden client and host validation evidence
5. expand tool domains only after the previous items are stable
1. define tool-schema compatibility rules and release policy in issue #17
2. continue core/interface cleanup in issue #18
3. reduce install and distribution friction beyond source checkout in issue #21
4. simplify the operator journey around primary workflows in issue #19
5. broaden client and host validation evidence in issue #2
6. keep `github/codeql-action` updates manual until the Dependabot failure tracked in issue #20 is resolved

## Out Of Scope For This Track

Expand Down
21 changes: 15 additions & 6 deletions docs/status.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Project Status

Snapshot date: 2026-03-23
Snapshot date: 2026-03-30

## Purpose

Expand All @@ -18,6 +18,7 @@ It is not the long-horizon roadmap.
- Install posture: source checkout plus `install.sh`
- Scope posture: single-host and local-first
- Packaging posture: no `.deb` package and no service-mode requirement yet
- Repository posture: public Apache-2.0 repository with security/support/conduct docs, branch protection, Dependabot, and working `pre-commit` hooks

## Current Product Statement

Expand All @@ -42,10 +43,13 @@ Chat and planner providers remain optional layers on top of the same runtime.
- modular Python monolith with `src/` layout
- SQLite bootstrap and local state directory
- architecture, security, roadmap, and ADR documentation
- published repository governance docs: `LICENSE`, `SECURITY.md`, `SUPPORT.md`, and `CODE_OF_CONDUCT.md`
- audit trail for plans, executions, provider errors, and recommendation status changes
- operator bootstrap scripts for install and removal
- repeatable bootstrap validation harness with per-step logs and cleanup checks
- GitHub CI bootstrap smoke for the non-editable operator path
- GitHub CI matrix on Python 3.11 and 3.13, with lint, typecheck, Bandit, tests, wheel smoke, doctor, and bootstrap validation
- working `pre-commit` baseline for whitespace, formatting, lint, typecheck, and Bandit
- host-validation bundle generation and community intake path

### Runtime capabilities
Expand Down Expand Up @@ -103,19 +107,21 @@ Chat and planner providers remain optional layers on top of the same runtime.
- chat/provider paths are optional and should not define the product center
- a first operator-configurable policy slice is landed through versioned TOML, but broader validation and operator evidence are still ahead
- approval concurrency is now hardened against duplicate active requests and duplicate in-flight execution for the same action envelope
- the public repository baseline is now materially stronger: Apache-2.0 license, governance docs, branch protection, `pre-commit`, Bandit, and Dependabot are in place
- tool-schema governance and broader runtime ownership cleanup are still ahead of the current baseline
- `github/codeql-action` is temporarily excluded from Dependabot automation due an updater-side failure tracked in issue #20; CodeQL action bumps are currently manual maintainer work

## Active Focus

The current execution focus is defined by `docs/runtime-mcp-maturation-plan.md`.

The next maturity steps are:

1. tool-schema compatibility rules and release policy
2. narrower runtime ownership seams, especially around `core.runtime` and `session_store`
3. container-backed integration harnesses for repeatable service/config scenarios
4. broader client evidence beyond the Inspector CLI transcript
5. broader tool expansion only after the runtime contract is stable
1. tool-schema compatibility rules and release policy in issue #17
2. narrower runtime ownership seams, especially around `core.runtime`, `session_store`, and `providers/heuristic` in issue #18
3. lower-friction install and distribution paths in issue #21
4. simpler product narrative around primary operator workflows in issue #19
5. broader client and host validation evidence in issue #2

## Intentionally Out Of Scope Right Now

Expand All @@ -132,10 +138,12 @@ At this snapshot, the project is validated by:

- `python3 -m ruff check .`
- `python3 -m mypy src`
- `python3 -m bandit -q --severity-level medium --confidence-level medium -c pyproject.toml -r src scripts`
- `PYTHONPATH=src python3 -m unittest discover -s tests`
- `PYTHONPATH=src python3 -m pytest -q`
- explicit runtime/MCP integration coverage in `tests/test_runtime_policy_integration.py` and `tests/test_mcp_stdio_integration.py`
- `python3 -m compileall src`
- `python3 -m pre_commit run --all-files`
- real-client MCP validation through `python3 scripts/validate_mcp_client.py`
- manual CLI smoke checks for chat, recommendations, recommendation-triggered actions, and `reconcile-timer render|install|remove`
- manual CLI smoke checks for managed config write with validation and backup
Expand All @@ -146,6 +154,7 @@ At this snapshot, the project is validated by:
- clean-environment operator bootstrap validation via `./install.sh`, `mc doctor`, `mc validate-host-profile`, and `./uninstall.sh --purge-state`
- packaging sanity check via `python3 -m pip wheel . --no-deps -w /tmp/mc-dist`
- dedicated Debian VPS operator-path validation on 2026-03-20
- GitHub `main` protection requiring `Analyze (python)`, `test (python-3.11)`, and `test (python-3.13)` after the 2026-03-30 repo-maturity publication pass

## Current Canonical Docs

Expand Down
Loading