Doc bug fix

Author: ddebowczyk

docs/features.md

@@ -534,17 +534,20 @@ Outputs:
 // Service provider auto-registers
 
 // Use facade
-use Cognesy\Instructor\Facades\Instructor;
+use Cognesy\Instructor\Laravel\Facades\StructuredOutput;
 
-$result = Instructor::respond()
-    ->withResponseClass(Person::class)
-    ->withMessages($text)
-    ->get();
+$result = StructuredOutput::using('openai')
+    ->with(
+        messages: $text,
+        responseModel: Person::class,
+    )->get();
 
-// Or inject
-public function handle(StructuredOutput $instructor)
+// Or inject via dependency injection
+public function handle(\Cognesy\Instructor\StructuredOutput $instructor)
 {
-    return $instructor->withResponseClass(Person::class)->get();
+    return $instructor
+        ->with(messages: $text, responseModel: Person::class)
+        ->get();
 }
 ```
 

docs/packages.md

@@ -140,17 +140,20 @@ Adds Laravel-specific conveniences: service provider, facades, config publishing
 ```php
 <?php
 // Use the facade
-use Cognesy\Instructor\Facades\Instructor;
+use Cognesy\Instructor\Laravel\Facades\StructuredOutput;
 
-$person = Instructor::respond()
-    ->withResponseClass(Person::class)
-    ->withMessages($text)
-    ->get();
+$person = StructuredOutput::using('openai')
+    ->with(
+        messages: $text,
+        responseModel: Person::class,
+    )->get();
 
 // Or inject via dependency injection
-public function extract(StructuredOutput $instructor)
+public function extract(\Cognesy\Instructor\StructuredOutput $instructor)
 {
-    return $instructor->withResponseClass(Person::class)->get();
+    return $instructor
+        ->with(messages: $text, responseModel: Person::class)
+        ->get();
 }
 ```
 

packages/doctools/resources/config/quality/profiles/instructor.yaml

@@ -77,3 +77,15 @@ rules:
     scope: markdown
     pattern: '/\bwithLLMConfigOverrides\s*\(/'
     message: 'Use `withConfigOverrides(...)` on LLMProvider.'
+
+  - id: instructor.no_instructor_facade
+    engine: regex
+    scope: markdown
+    pattern: '/\bFacades\\\\Instructor\b/'
+    message: 'There is no Instructor facade. Use `Cognesy\Instructor\Laravel\Facades\StructuredOutput` instead.'
+
+  - id: instructor.no_instructor_static_call
+    engine: regex
+    scope: markdown
+    pattern: '/\bInstructor::(respond|with|create)\s*\(/'
+    message: 'Instructor has no static facade methods. Use `StructuredOutput::with(...)` or `(new StructuredOutput)->with(...)` instead.'

packages/laravel/docs/commands.md

@@ -41,7 +41,7 @@ Next steps:
      php artisan make:response-model PersonData
 
   3. Extract structured data:
-     $person = Instructor::with(
+     $person = StructuredOutput::with(
          messages: "John is 30 years old",
          responseModel: PersonData::class,
      )->get();

packages/laravel/src/Console/InstructorInstallCommand.php

@@ -125,7 +125,7 @@ protected function showNextSteps(): void
         $this->newLine();
 
         $this->line('  3. Extract structured data:');
-        $this->line('     <comment>$person = Instructor::with(</comment>');
+        $this->line('     <comment>$person = StructuredOutput::with(</comment>');
         $this->line('         <comment>messages: "John is 30 years old",</comment>');
         $this->line('         <comment>responseModel: PersonData::class,</comment>');
         $this->line('     <comment>)->get();</comment>');

packages/laravel/src/Facades/Inference.php

@@ -15,6 +15,7 @@
  * Facade for Inference
  *
  * @method static \Cognesy\Polyglot\Inference\Inference connection(string $name)
+ * @method static \Cognesy\Polyglot\Inference\Inference using(string $name)
  * @method static \Cognesy\Polyglot\Inference\Inference fromConfig(\Cognesy\Polyglot\Inference\Config\LLMConfig $config)
  * @method static \Cognesy\Polyglot\Inference\Inference withRuntime(\Cognesy\Polyglot\Inference\Contracts\CanCreateInference $runtime)
  * @method static \Cognesy\Polyglot\Inference\Inference with(?\Cognesy\Messages\Messages $messages = null, ?string $model = null, ?\Cognesy\Polyglot\Inference\Data\ToolDefinitions $tools = null, ?\Cognesy\Polyglot\Inference\Data\ToolChoice $toolChoice = null, ?\Cognesy\Polyglot\Inference\Data\ResponseFormat $responseFormat = null, ?array $options = null)
@@ -67,6 +68,14 @@ public static function connection(string $name): BaseInference|InferenceFake
         return static::fromConfig(static::resolveLLMConfig($name));
     }
 
+    /**
+     * Alias for connection() — matches the base Inference::using() API.
+     */
+    public static function using(string $name): BaseInference|InferenceFake
+    {
+        return static::connection($name);
+    }
+
     /**
      * Replace the Inference instance with a fake for testing.
      */

packages/laravel/src/Facades/StructuredOutput.php

@@ -13,6 +13,7 @@
  * Facade for StructuredOutput
  *
  * @method static \Cognesy\Instructor\StructuredOutput connection(string $name)
+ * @method static \Cognesy\Instructor\StructuredOutput using(string $name)
  * @method static \Cognesy\Instructor\StructuredOutput fromConfig(\Cognesy\Polyglot\Inference\Config\LLMConfig $config)
  * @method static \Cognesy\Instructor\StructuredOutput withRuntime(\Cognesy\Instructor\Contracts\CanCreateStructuredOutput $runtime)
  * @method static \Cognesy\Instructor\StructuredOutput with(string|array|\Cognesy\Messages\Message|\Cognesy\Messages\Messages|null $messages = null, string|array|object|null $responseModel = null, ?string $system = null, ?string $prompt = null, ?array $examples = null, ?string $model = null, ?array $options = null)
@@ -74,6 +75,14 @@ public static function connection(string $name): BaseStructuredOutput|Structured
         return static::fromConfig(static::resolveLLMConfig($name));
     }
 
+    /**
+     * Alias for connection() — matches the base StructuredOutput::using() API.
+     */
+    public static function using(string $name): BaseStructuredOutput|StructuredOutputFake
+    {
+        return static::connection($name);
+    }
+
     /**
      * Replace the StructuredOutput instance with a fake for testing.
      */