feature:drift

Introduction

feature:drift shows which scaffold files SPLENT owns in your feature differ from what the current CLI’s templates would write. It only reads. Run it after you update the CLI, then apply the changes with feature:sync-template.

splent feature:drift notes

  Drift report for splent_io/splent_feature_notes   (generated with CLI v1.0.0, current CLI v1.2.1)
  ────────────────────────────────────────────────────────────────────────
  /workspace/splent_feature_notes

  scaffold files  [SPLENT-owned — safe to update]
    .gitignore                                         ✔  up to date
    MANIFEST.in                                        ✔  up to date
    webpack.config.js                                  ⚠  3 line(s) changed

  Run 'splent feature:sync-template' to apply changes.

When nothing differs, the last line is ✅ All SPLENT-owned files are up to date.

Seeing what changed

splent feature:drift notes --verbose

--verbose (or -v) prints the unified diff of every changed file, your copy against the template.

Files checked

Feature	Files
Without `frontend/`	`.gitignore` and `MANIFEST.in` at the root, and `src/<namespace>/<name>/assets/js/webpack.config.js`
With `frontend/`	`.gitignore` and `MANIFEST.in` at the root, and `frontend/.npmrc`

Your code, your templates and pyproject.toml, which feature:contract manages, are never inspected. A file the feature does not have shows as up to date.

Reference

Argument or option	Description
`FEATURE_IDENTIFIER`	A short name (`notes`) or a package name (`splent_feature_notes`), either one under a namespace (`splent-io/notes`), optionally with `@<version>`
`--verbose`, `-v`	Show the full diff of every changed file

It reads the working copy at the workspace root first, then an unversioned copy in .splent_cache, then a snapshot, the one you name with @<version>, else the one the selected product pins, else the highest. The report prints the directory it read under its header.

Message	Meaning
`(generated with unknown CLI version)`	The feature’s `pyproject.toml` records no CLI version
`Feature '<id>' not found at the workspace root or in .splent_cache.`	No copy to read. Exits 1

Requirements

A selected product (SPLENT_APP).