Fix static analysis: widen return types to static and add explicit Container/K8sSecret methods

- Change get(), create(), createOrUpdate(), syncWithCluster() return types
  from K8sResource to static so concrete subclass methods are visible to
  PHPStan/Psalm after cluster operations
- Change updateStatus(), jsonPatchStatus(), jsonMergePatchStatus() from
  self to static to maintain the covariant chain in subclasses
- Add explicit setName/getName, setImagePullPolicy/getImagePullPolicy,
  setCommand/getCommand, setArgs/getArgs, setWorkingDir/getWorkingDir
  methods on Container instead of relying on __call magic
- Add explicit setType/getType methods on K8sSecret instead of relying
  on __call magic

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: loks0n

src/Instances/Container.php

@@ -4,6 +4,22 @@
 
 class Container extends Instance
 {
+    /**
+     * Set the container name.
+     */
+    public function setName(string $name): static
+    {
+        return $this->setAttribute('name', $name);
+    }
+
+    /**
+     * Get the container name.
+     */
+    public function getName(): ?string
+    {
+        return $this->getAttribute('name');
+    }
+
     /**
      * Set the image for the container.
      *
@@ -14,6 +30,70 @@ public function setImage(string $image, string $tag = 'latest')
         return $this->setAttribute('image', $image.':'.$tag);
     }
 
+    /**
+     * Set the image pull policy.
+     */
+    public function setImagePullPolicy(string $policy): static
+    {
+        return $this->setAttribute('imagePullPolicy', $policy);
+    }
+
+    /**
+     * Get the image pull policy.
+     */
+    public function getImagePullPolicy(): ?string
+    {
+        return $this->getAttribute('imagePullPolicy');
+    }
+
+    /**
+     * Set the command (entrypoint) for the container.
+     */
+    public function setCommand(array $command): static
+    {
+        return $this->setAttribute('command', $command);
+    }
+
+    /**
+     * Get the command (entrypoint) for the container.
+     */
+    public function getCommand(): array
+    {
+        return $this->getAttribute('command', []);
+    }
+
+    /**
+     * Set the args for the container.
+     */
+    public function setArgs(array $args): static
+    {
+        return $this->setAttribute('args', $args);
+    }
+
+    /**
+     * Get the args for the container.
+     */
+    public function getArgs(): array
+    {
+        return $this->getAttribute('args', []);
+    }
+
+    /**
+     * Set the working directory for the container.
+     */
+    public function setWorkingDir(string $dir): static
+    {
+        return $this->setAttribute('workingDir', $dir);
+    }
+
+    /**
+     * Get the working directory for the container.
+     */
+    public function getWorkingDir(): ?string
+    {
+        return $this->getAttribute('workingDir');
+    }
+
     /**
      * Add a new port to the container list.
      *

src/Kinds/K8sSecret.php

@@ -24,6 +24,22 @@ class K8sSecret extends K8sResource implements InteractsWithK8sCluster, Watchabl
      */
     protected static $namespaceable = true;
 
+    /**
+     * Set the secret type.
+     */
+    public function setType(string $type): static
+    {
+        return $this->setAttribute('type', $type);
+    }
+
+    /**
+     * Get the secret type.
+     */
+    public function getType(): ?string
+    {
+        return $this->getAttribute('type');
+    }
+
     /**
      * Get the data attribute.
      * Supports base64 decoding.

src/Traits/RunsClusterOperations.php

@@ -111,10 +111,8 @@ public function refreshResourceVersion()
     /**
      * Create or update the resource, wether the resource exists
      * or not within the cluster.
-     *
-     * @return $this
      */
-    public function syncWithCluster(array $query = ['pretty' => 1])
+    public function syncWithCluster(array $query = ['pretty' => 1]): static
     {
         try {
             return $this->get($query);
@@ -125,10 +123,8 @@ public function syncWithCluster(array $query = ['pretty' => 1])
 
     /**
      * Create or update the app based on existence.
-     *
-     * @return $this
      */
-    public function createOrUpdate(array $query = ['pretty' => 1])
+    public function createOrUpdate(array $query = ['pretty' => 1]): static
     {
         if ($this->exists($query)) {
             $this->update($query);
@@ -180,11 +176,10 @@ public function allNamespaces(array $query = ['pretty' => 1])
     /**
      * Get a fresh instance from the cluster.
      *
-     * @return \RenokiCo\PhpK8s\Kinds\K8sResource
      *
      * @throws \RenokiCo\PhpK8s\Exceptions\KubernetesAPIException
      */
-    public function get(array $query = ['pretty' => 1])
+    public function get(array $query = ['pretty' => 1]): static
     {
         return $this->cluster
             ->setResourceClass(get_class($this))
@@ -199,11 +194,10 @@ public function get(array $query = ['pretty' => 1])
     /**
      * Create the resource.
      *
-     * @return \RenokiCo\PhpK8s\Kinds\K8sResource
      *
      * @throws \RenokiCo\PhpK8s\Exceptions\KubernetesAPIException
      */
-    public function create(array $query = ['pretty' => 1])
+    public function create(array $query = ['pretty' => 1]): static
     {
         return $this->cluster
             ->setResourceClass(get_class($this))
@@ -622,7 +616,7 @@ public function resourceStatusPath(): string
     /**
      * Update the status subresource.
      */
-    public function updateStatus(array $query = ['pretty' => 1]): self
+    public function updateStatus(array $query = ['pretty' => 1]): static
     {
         $this->refreshOriginal();
         $this->refreshResourceVersion();
@@ -640,7 +634,7 @@ public function updateStatus(array $query = ['pretty' => 1]): self
     /**
      * JSON Patch (RFC 6902) the status subresource.
      */
-    public function jsonPatchStatus($patch, array $query = ['pretty' => 1]): self
+    public function jsonPatchStatus($patch, array $query = ['pretty' => 1]): static
     {
         if (! $patch instanceof \RenokiCo\PhpK8s\Patches\JsonPatch) {
             $patch = new \RenokiCo\PhpK8s\Patches\JsonPatch($patch);
@@ -663,7 +657,7 @@ public function jsonPatchStatus($patch, array $query = ['pretty' => 1]): self
     /**
      * JSON Merge Patch (RFC 7396) the status subresource.
      */
-    public function jsonMergePatchStatus($patch, array $query = ['pretty' => 1]): self
+    public function jsonMergePatchStatus($patch, array $query = ['pretty' => 1]): static
     {
         if (! $patch instanceof \RenokiCo\PhpK8s\Patches\JsonMergePatch) {
             $patch = new \RenokiCo\PhpK8s\Patches\JsonMergePatch($patch);