Cognotik | AbstractFileTask

⚙️ FileTaskExecutionConfig


{
  "files": ["src/**/*.kt"],
  "related_files": ["docs/spec.pdf"],
  "extractContent": true,
  "task_description": "Analyze project structure"
}

→

👁️ Resolved Context

// Resolved Input Files:

# src/main/App.kt

```kotlin ... ```

// Extracted Content (PDF):

# docs/spec.pdf

```text [Extracted via PaginatedReader] ... ```

Test Workspace Explorer

Browse the file structure and resolved context from the AbstractFileTask test suite. This demonstrates how the task handles glob patterns and binary filtering in a real environment.

Execution Configuration

Field	Type	Description
`files` *	`List<String>`	Relative paths or glob patterns (e.g. `*/.js`) for output/target files.
`related_files`	`List<String>`	Additional context files. Supports glob patterns.
`extractContent`	`Boolean`	If true, uses `PaginatedDocumentReader` to pull text from PDFs, HTML, etc. Defaults to `false`.

Automatic Filtering

The task automatically ignores binary and media files unless content extraction is explicitly enabled. Ignored extensions include:

.class, .jar, .exe, .png, .jpg, .mp4, .zip, .dll

Embedded Invocation

To use tasks derived from AbstractFileTask in an automated pipeline, use the UnifiedHarness.


import com.simiacryptus.cognotik.apps.general.UnifiedHarness
import com.simiacryptus.cognotik.plan.TaskType
import com.simiacryptus.cognotik.plan.tools.file.FileModificationTaskExecutionConfigData

val harness = UnifiedHarness(serverless = true).apply { start() }

// Example: Running a FileModificationTask (which extends AbstractFileTask)
harness.runTask(
    taskType = TaskType.FileModificationTask,
    typeConfig = FileModificationTaskTypeConfig(name = "AutoRefactor"),
    executionConfig = FileModificationTaskExecutionConfigData(
        files = listOf("src/**/*.kt"),
        related_files = listOf("docs/architecture.md"),
        extractContent = true,
        modifications = "Update copyright headers to 2024"
    ),
    workspace = File("./my-project"),
    autoFix = true
)

Test Case Example

For unit testing your own tasks, you can mock the OrchestrationConfig and provide a local filesystem root:


val config = OrchestrationConfig(
    sessionId = "test-session",
    workingDir = tempDir.absolutePath
)
val task = MyFileTask(config, MyExecutionConfig(files = listOf("test.txt")))
task.run()

Extending the Base Class