@edcalderon/versioning 1.1.0 → 1.2.0

package/README.md

@@ -113,32 +113,83 @@ Features:
 - Local registry support
 - Dry-run mode
 
-#### Re-entry Status + Roadmap Extension
+### Re-entry Status + Roadmap Extension
 
 Maintains a fast **re-entry** layer (current state + next micro-step) and a slow **roadmap/backlog** layer (long-term plan).
 
 Canonical files:
+
+Single-project (default):
 - `.versioning/reentry.status.json` (machine)
 - `.versioning/REENTRY.md` (generated, minimal diffs)
 - `.versioning/ROADMAP.md` (human-first; only a small managed header block is auto-updated)
 
+Multi-project (scoped by `--project <name>`):
+- `.versioning/projects/<project>/reentry.status.json`
+- `.versioning/projects/<project>/REENTRY.md`
+- `.versioning/projects/<project>/ROADMAP.md`
+
+**Smart Features:**
+- **Auto-Update:** `versioning reentry update` infers the project phase and next step from your last git commit.
+  - `feat: ...` → **Phase: development**
+  - `fix: ...` → **Phase: maintenance**
+- **Git Context:** Automatically links status to the latest branch, commit, and author.
+
 Commands:
 
 ```bash
 # Fast layer
 versioning reentry init
+versioning reentry update        # Auto-update status from git commit
+versioning reentry show          # Show current status summary
 versioning reentry sync
 
+# Fast layer (scoped)
+versioning reentry init --project trader
+versioning reentry update --project trader
+versioning reentry show --project trader
+
 # Slow layer
 versioning roadmap init --title "My Project"
 versioning roadmap list
 versioning roadmap set-milestone --id "now-01" --title "Ship X"
-versioning roadmap add --section "Now (1–2 weeks)" --id "now-02" --item "Add observability"
 ```
 
-Backward compatibility:
-- v1.0 status files load safely.
-- Schema migrates to v1.1 only when you actually modify status, or explicitly via `versioning reentry sync --migrate`.
+#### Cleanup Repo Extension
+
+Keeps your repository root clean by organizing stray files into appropriate directories (docs, scripts, config, archive).
+
+Features:
+- **Smart Scanning:** Identifies files that don't belong in the root.
+- **Configurable Routes:** Map extensions to folders (e.g. `.sh` → `scripts/`).
+- **Safety:** Allowlist for root files and Denylist for forced moves.
+- **Husky Integration:** Auto-scan or auto-move on commit.
+
+Commands:
+
+```bash
+versioning cleanup scan          # Dry-run scan of root
+versioning cleanup move          # Move files to configured destinations
+versioning cleanup restore       # Restore a moved file
+versioning cleanup config        # View/manage configuration
+versioning cleanup husky         # Setup git hook
+```
+
+Configuration (`versioning.config.json`):
+
+```json
+{
+  "cleanup": {
+    "enabled": true,
+    "defaultDestination": "docs",
+    "allowlist": ["CHANGELOG.md"],
+    "routes": {
+      ".sh": "scripts",
+      ".json": "config"
+    }
+  }
+}
+```
 
 ### External Extensions
 

package/dist/extensions/cleanup-repo-extension.d.ts

@@ -0,0 +1,49 @@
+import { VersioningExtension } from '../extensions';
+/**
+ * The canonical cleanup configuration schema.
+ * Everything the plugin needs lives here.
+ */
+export interface CleanupRepoConfig {
+    /** Master switch. Default: true */
+    enabled: boolean;
+    /** Default destination for files without a specific route. Default: "docs" */
+    defaultDestination: string;
+    /**
+     * Files explicitly allowed to stay in root (on top of built-in essentials).
+     * Supports exact filenames and glob-like patterns (e.g. "*.config.js").
+     */
+    allowlist: string[];
+    /**
+     * Files that should ALWAYS be moved, even if they match the allowlist.
+     * Useful for forcing cleanup of specific known offenders.
+     */
+    denylist: string[];
+    /**
+     * File extensions to consider for cleanup (with leading dot).
+     * Default: [".md", ".sh", ".json", ".yaml", ".yml", ".txt", ".log"]
+     */
+    extensions: string[];
+    /**
+     * Mapping of file extension → destination directory.
+     * Overrides defaultDestination per extension.
+     */
+    routes: Record<string, string>;
+    /**
+     * Husky integration settings.
+     */
+    husky: {
+        enabled: boolean;
+        /** Which husky hook to attach to. Default: "pre-commit" */
+        hook: string;
+        /** "scan" = warning only, "enforce" = auto-move + git add. Default: "scan" */
+        mode: 'scan' | 'enforce';
+    };
+}
+declare const BUILTIN_ALLOWLIST: Set<string>;
+declare const DEFAULT_EXTENSIONS: string[];
+declare const DEFAULT_ROUTES: Record<string, string>;
+declare function loadCleanupConfig(rootConfig: any): CleanupRepoConfig;
+declare const extension: VersioningExtension;
+export { loadCleanupConfig, BUILTIN_ALLOWLIST, DEFAULT_EXTENSIONS, DEFAULT_ROUTES };
+export default extension;
+//# sourceMappingURL=cleanup-repo-extension.d.ts.map