codespeak update-managed-files
Add files to the managed files list for a specific spec.
Synopsis
codespeak update-managed-files [paths...] [--spec SPEC]Description
Adds given files to the list of managed files for a spec. By default (when no paths are given), adds the files that were flagged as managed file violations during the last build.
Unlike codespeak whitelist which is project-wide, this command gives per-spec control — the file is only managed by the specified spec.
Files that don't exist on disk are silently filtered out. The command requires exactly one spec to be registered (use --spec if multiple specs exist).
Flags
| Flag | Description |
|---|---|
paths | Files or directories to add as managed files. Defaults to the violations from the last build |
--spec SPEC | Path to the specification file. If omitted, all registered specs are considered |
Examples
Add a specific file to a spec's managed files:
codespeak update-managed-files 'pyproject.toml'Add all files that violated managed file rules in the last build:
codespeak update-managed-filesError messages
| Error | Cause | Resolution |
|---|---|---|
| Can't find spec to build | No .cs.md files found and no specs registered in codespeak.json | Create a spec file or register one in codespeak.json |
| Circular spec dependency detected: A -> B -> A | Spec imports form a cycle | Remove the circular import |
| {path} does not belong to a CodeSpeak project | No codespeak.json found | Run codespeak init first |
| No paths provided, and the last run doesn't have any recorded managed files violations | No explicit paths and no violations from last build | Provide explicit paths or run a build first |
See also
- Managed Files — how CodeSpeak tracks file ownership
codespeak whitelist— project-wide file allowance