Keep the CLI out of the PHP API

The previous commit widened five endpoints from `class` to `classLike`,
changed the PSR-2 printer's return-type spacing, added enum() and
enumCase() to the query builder, and put --json on archetype:errors.
None of that belongs in a change whose job is to add a command line, and
one of them was an outright regression: on a file declaring both an
interface and a class, className() started answering about the interface
and property() started writing into it, which is not valid PHP.

All of it is reverted. `src/` is now the new `src/Console` tree plus two
lines in the service provider, and nothing an existing user calls behaves
differently.

The console pays for that in reach, and says so rather than pretending
otherwise. The endpoints it drives address `class` declarations, so the
property, constant, interface, trait, parent-class and rename operations
refuse an enum, interface or trait outright:

    ERR app/Enums/Status.php archetype:add-implements only works on
    classes, and this is an enum

Refusing up front rather than after the fact matters for the three
operations that import a name before using it. add-implements on an enum
used to write the import, fail to add the interface, and report OK — a
half-done change is indistinguishable from a whole one once the file has
changed, so the render-and-compare check cannot catch it.

inspect, show, find, the method operations, add-case and set-array-key
have no such limit; they read and write the declaration through the
console's own code whatever it is.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AjUMv5rFTVJMr6F1J7bx7x

Author: ajthinking

CHANGELOG.md

@@ -8,8 +8,8 @@ This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [2.1.0] - 2026-08-29
 
-Adds a command line to Archetype. Every existing PHP API is untouched; a handful
-of endpoints now reach constructs they previously matched but silently ignored.
+Adds a command line to Archetype. The PHP API is untouched — no endpoint, no
+printer and no query builder changes. Everything new lives in `src/Console`.
 
 ### Added
 
@@ -28,13 +28,17 @@ of endpoints now reach constructs they previously matched but silently ignored.
 - Every operation takes a single target, which is a path, a class name, or a
   directory — where a directory means every class beneath it, narrowed with
   `--extends`, `--implements`, `--uses-trait` or `--matching`.
-- Every operation takes `--json`.
+- Every operation but `errors` takes `--json`.
 - Every mutation re-renders the file and compares before reporting. One that
   matched nothing exits non-zero rather than reporting a success that wrote
   nothing; one whose change is already present reports `SKIP`, which makes the
   operations safe to repeat.
 - Every mutation answers with a diff of what it changed, and takes `--dry-run`
   to show that diff without writing.
+- An operation that cannot act on the construct it was pointed at refuses before
+  writing anything, rather than writing the part it can. `add-implements`,
+  `add-trait` and `set-extends` import a name before using it, so a half-done
+  change would otherwise look like a whole one.
 - `archetype apply` runs a script of operations in one invocation, reading a file
   or standard input.
 - `set-casts` writes to whichever casting mechanism a model already uses — the
@@ -44,18 +48,14 @@ of endpoints now reach constructs they previously matched but silently ignored.
   `toArray()`, `casts()` and `definition()` keep their contents.
 - `add-relation` covers all eleven Eloquent relation types, with pivot tables,
   explicit keys, `withPivot`, `withTimestamps` and a custom pivot model.
-- `enum()` and `enumCase()` query methods on the `ASTQueryBuilder`.
-- `php artisan archetype:errors` takes `--json`.
 
-### Changed
+### Known limits
 
-- `className()`, `classConstant()`, `useTrait()` and `property()` now match any
-  class-like declaration rather than only `class`, so they work on enums,
-  interfaces and traits. `implements()` matches classes and enums. Previously
-  these silently did nothing on anything but a class.
-- The PSR-2 pretty printer prints `function name(): Type` rather than
-  `function name() : Type`. Only newly printed declarations are affected;
-  untouched code keeps its own formatting.
+- The property, constant, interface, trait, parent-class and rename operations
+  work on classes only, because the endpoints they drive address `class`
+  declarations. On an enum, interface or trait they refuse and write nothing.
+  `inspect`, `show`, `find`, the method operations, `add-case` and
+  `set-array-key` have no such limit.
 
 ## [2.0.1] - 2026-08-25
 

docs.md

@@ -200,6 +200,8 @@ These options are rejected on a single-file target rather than ignored.
 |---|---|
 | `--json` | Emit JSON instead of the compact line format |
 
+`errors` predates this console and does not take it.
+
 ### Options every mutation takes
 
 | Option | Effect |
@@ -367,8 +369,7 @@ archetype add-case app/Enums/ProjectStatus.php OnHold on_hold
 archetype add-case app/Enums/Suit.php Spades          # pure enum, no backing value
 ```
 
-Constants work on classes, interfaces, enums and traits. New enum cases are
-added after the ones already there.
+New enum cases are added after the ones already there.
 
 ### Methods
 
@@ -383,6 +384,23 @@ archetype remove-method app/Models/Project.php isActive
 Methods can be added to a class, enum, interface or trait, and are appended
 after the methods already there.
 
+### What the console will not do
+
+`set-property`, `add-to-property`, `empty-property`, `remove-property`,
+`set-casts`, `set-const`, `remove-const`, `add-implements`, `add-trait`,
+`set-extends` and `rename-class` work on classes only. On an enum, interface or
+trait they refuse and write nothing, rather than writing the part they can and
+reporting success:
+
+```
+$ archetype add-implements app/Enums/Status.php 'App\Contracts\HasColor'
+ERR app/Enums/Status.php archetype:add-implements only works on classes, and this is an enum
+```
+
+`inspect`, `show`, `find`, `add-method`, `replace-method`, `remove-method`,
+`add-case` and `set-array-key` have no such limit — they read or write the
+declaration whatever it is.
+
 ### Several operations in one call
 
 ```bash

readme.md

@@ -256,7 +256,8 @@ OK app/Models/User.php $fillable +1
 Three rules hold for every operation that writes:
 
 * it re-renders the file and compares, so a change that matched nothing is an
-  error and exits non-zero — never a success that wrote nothing;
+  error and exits non-zero — never a success that wrote nothing, and never half
+  a change reported as a whole one;
 * it answers with a diff, so you do not have to read the file back to see what
   happened;
 * a change already applied is `SKIP`, not `OK` and not an error, so operations

src/Commands/ErrorsCommand.php

@@ -9,7 +9,7 @@
 
 class ErrorsCommand extends Command
 {
-    protected $signature = 'archetype:errors {--json : Emit JSON instead of a table}';
+    protected $signature = 'archetype:errors';
     protected $description = 'List dirty files';
 	protected $result;
 	protected $errors;
@@ -33,15 +33,6 @@ public function handle()
             }
         });
 
-        if ($this->option('json')) {
-            $this->output->writeln(json_encode([
-                'ok' => $this->errors->isEmpty(),
-                'errors' => $this->errors->values()->all(),
-            ], JSON_UNESCAPED_SLASHES));
-
-            return;
-        }
-
         if ($this->errors->isEmpty()) {
             $this->info('No errors found!');
 			return;

src/Console/Commands/AddImplementsCommand.php

@@ -18,6 +18,8 @@ protected function perform(): int
         $interfaces = $this->argument('interfaces');
 
         return $this->mutate(function (LaravelFile $file) use ($interfaces) {
+            $this->requireKind($file, ['class']);
+
             $existing = array_map(fn ($name) => class_basename($name), $file->implements());
 
             $wanted = array_values(array_filter(

src/Console/Commands/AddToPropertyCommand.php

@@ -25,7 +25,7 @@ protected function perform(): int
         $values = $this->argument('values');
 
         return $this->mutate(function (LaravelFile $file) use ($name, $values) {
-            $this->requirePropertyHolder($file);
+            $this->requireKind($file, ['class']);
 
             $visibility = $this->visibilityOf($file, $name, $this->option('visibility'));
             $existing = $file->property($name);

src/Console/Commands/AddTraitCommand.php

@@ -18,6 +18,8 @@ protected function perform(): int
         $traits = $this->argument('traits');
 
         return $this->mutate(function (LaravelFile $file) use ($traits) {
+            $this->requireKind($file, ['class']);
+
             $existing = array_map(fn ($trait) => class_basename($trait), $file->useTrait());
 
             $wanted = array_values(array_filter(

src/Console/Commands/EmptyPropertyCommand.php

@@ -19,7 +19,7 @@ protected function perform(): int
         $name = $this->argument('name');
 
         return $this->mutate(function (LaravelFile $file) use ($name) {
-            $this->requirePropertyHolder($file);
+            $this->requireKind($file, ['class']);
 
             if (! (new Introspector($file))->hasProperty($name)) {
                 return $this->unchanged("no \$$name");

src/Console/Commands/RemoveConstCommand.php

@@ -19,6 +19,8 @@ protected function perform(): int
         $name = $this->argument('name');
 
         return $this->mutate(function (LaravelFile $file) use ($name) {
+            $this->requireKind($file, ['class']);
+
             $present = collect((new Introspector($file))->constants())
                 ->contains(fn ($constant) => $constant['name'] === $name);
 

src/Console/Commands/RemovePropertyCommand.php

@@ -19,6 +19,8 @@ protected function perform(): int
         $name = $this->argument('name');
 
         return $this->mutate(function (LaravelFile $file) use ($name) {
+            $this->requireKind($file, ['class']);
+
             if (! (new Introspector($file))->hasProperty($name)) {
                 return $this->unchanged("no \$$name");
             }