indusagi-coding-agent 0.1.59 → 0.1.61

package/guides/OPTION3_PROVIDER_ADAPTER_RUNTIME_PLAN.md

@@ -1,370 +0,0 @@
-# Option 3 Plan: Full Provider Adapter Runtime (Claude CLI / Codex CLI / Indusagi CLI)
-
-## Objective
-
-Implement a **production-grade provider runtime layer** in `indusagi-screth` so CLI-backed providers behave as first-class runtimes, not just `streamSimple` wrappers.
-
-Target providers:
-
-- `claude-cli`
-- `codex-cli`
-- `indusagi-cli`
-
----
-
-## Success Criteria
-
-1. Selecting any of the 3 providers routes execution through a dedicated adapter runtime.
-2. Session lifecycle is explicit: start, send turn, interrupt, shutdown, recover.
-3. Provider events are normalized into the existing `AssistantMessageEventStream` path.
-4. Session state persists enough metadata to resume reliably.
-5. Existing API providers keep working unchanged.
-
----
-
-## Current Constraints in Codebase
-
-Relevant current flow:
-
-- Provider registration and model list:
-  - `app/runtime/model-registry.ts`
-- Stream execution path:
-  - `app/runtime/sdk.ts` (`createStreamWithHooks` -> `streamSimple(...)`)
-- Session orchestration and persistence:
-  - `app/runtime/agent-session.ts`
-  - `app/runtime/session-manager.ts`
-- Extension registration queue:
-  - `app/runtime/plugins/loader.ts`
-  - `app/runtime/plugins/runner.ts`
-  - `app/main.ts`
-- Existing RPC client (useful for `indusagi-cli` adapter):
-  - `app/interfaces/service-api/rpc-client.ts`
-
-Problem: current runtime assumes model API adapters. CLI runtimes require their own session/event lifecycle.
-
----
-
-## Target Architecture
-
-## 1) New Provider Runtime Module
-
-Create a new module tree:
-
-- `app/runtime/providers/types.ts`
-- `app/runtime/providers/provider-adapter.ts`
-- `app/runtime/providers/provider-adapter-registry.ts`
-- `app/runtime/providers/provider-service.ts`
-- `app/runtime/providers/adapters/claude-cli-adapter.ts`
-- `app/runtime/providers/adapters/codex-cli-adapter.ts`
-- `app/runtime/providers/adapters/indusagi-cli-adapter.ts`
-
-## 2) Core Interfaces
-
-### `ProviderAdapter`
-
-```ts
-export interface ProviderAdapter {
-  readonly id: string;
-  supports(provider: string): boolean;
-
-  startSession(input: {
-    provider: string;
-    modelId: string;
-    sessionId: string;
-    cwd: string;
-  }): Promise<ProviderSessionHandle>;
-
-  streamTurn(input: {
-    handle: ProviderSessionHandle;
-    model: Model<Api>;
-    context: Context;
-    options?: SimpleStreamOptions;
-  }): AssistantMessageEventStream;
-
-  interrupt(handle: ProviderSessionHandle): Promise<void>;
-  stopSession(handle: ProviderSessionHandle): Promise<void>;
-  healthCheck?(): Promise<{ ok: boolean; reason?: string }>;
-}
-```
-
-### `ProviderSessionHandle`
-
-Contains adapter-managed runtime identity and metadata:
-
-- `adapterId`
-- `provider`
-- `modelId`
-- `runtimeSessionId` (thread/conversation/process id)
-- adapter-specific opaque payload
-
-## 3) `ProviderService`
-
-Responsibilities:
-
-- decide whether a model/provider should use adapter runtime
-- get or create adapter session handle for current agent session
-- stream one turn via adapter
-- interrupt/cleanup active runtime
-- persist runtime metadata for restore
-
-Internal state map:
-
-- `Map<agentSessionId, ProviderSessionHandle>`
-
-## 4) Adapter Registry
-
-Responsibilities:
-
-- register adapters
-- resolve by provider id
-- expose diagnostics for availability checks
-
----
-
-## Integration Plan (File-Level)
-
-## Phase 0 — Scaffolding
-
-### Add new files
-
-- `app/runtime/providers/types.ts`
-- `app/runtime/providers/provider-adapter.ts`
-- `app/runtime/providers/provider-adapter-registry.ts`
-- `app/runtime/providers/provider-service.ts`
-
-### Add lightweight tests
-
-- `tests/runtime/providers/provider-adapter-registry.test.ts`
-- `tests/runtime/providers/provider-service.test.ts`
-
----
-
-## Phase 1 — Runtime Routing in SDK
-
-### Modify `app/runtime/sdk.ts`
-
-1. Create `ProviderAdapterRegistry` during `createAgentSession()` bootstrap.
-2. Register built-in adapters (`claude-cli`, `codex-cli`, `indusagi-cli`).
-3. Create `ProviderService` and inject references:
-   - session id from `SessionManager`
-   - cwd
-4. Update `createStreamWithHooks(...)`:
-   - before `streamSimple(...)`, call provider service:
-     - if adapter exists for `model.provider`, use `providerService.streamTurn(...)`
-     - else fallback to existing `streamSimple(...)`
-
-Result: model/API providers unaffected; only targeted CLI providers reroute.
-
----
-
-## Phase 2 — Provider Metadata + Validation
-
-### Modify `app/runtime/model-registry.ts`
-
-Add provider runtime metadata support in `ProviderConfigInput`:
-
-```ts
-runtime?: {
-  adapter: "claude-cli" | "codex-cli" | "indusagi-cli" | string;
-  authMode?: "apiKey" | "oauth" | "external-cli" | "none";
-}
-```
-
-Changes:
-
-1. Persist runtime config per provider in registry map.
-2. Add `getProviderRuntime(provider: string)` accessor.
-3. Relax validation for `models` when runtime auth is external:
-   - if `runtime.authMode` is `external-cli` or `none`, do not require `apiKey/oauth`.
-4. Keep existing validation for normal HTTP API providers.
-
-### Modify extension type surface
-
-- `app/runtime/plugins/types.ts`
-  - extend `ProviderConfig` with same `runtime` field.
-
----
-
-## Phase 3 — Session Persistence for Adapter State
-
-### Modify `app/runtime/session-manager.ts`
-
-Use existing custom entry mechanism:
-
-- `appendCustomEntry("provider_runtime", data)`
-
-Persist after adapter session creation/update:
-
-```json
-{
-  "type": "custom",
-  "customType": "provider_runtime",
-  "data": {
-    "provider": "codex-cli",
-    "adapterId": "codex-cli",
-    "modelId": "gpt-5.4-1m",
-    "runtimeSessionId": "...",
-    "timestamp": "..."
-  }
-}
-```
-
-On startup, `ProviderService` should inspect latest relevant custom entry and attempt restore.
-
----
-
-## Phase 4 — Adapter Implementations
-
-## 4.1 `IndusagiCliAdapter` (first, easiest)
-
-File:
-
-- `app/runtime/providers/adapters/indusagi-cli-adapter.ts`
-
-Implementation:
-
-- use existing `RpcClient` (`app/interfaces/service-api/rpc-client.ts`)
-- start subprocess in `--mode rpc`
-- set provider/model if needed
-- map incoming RPC events to `AssistantMessageEventStream` events
-- support interrupt/stop cleanly
-
-Why first: strong existing API and event stream already available.
-
-## 4.2 `CodexCliAdapter`
-
-File:
-
-- `app/runtime/providers/adapters/codex-cli-adapter.ts`
-
-Implementation approach:
-
-- mimic t3code `codex app-server` management pattern
-- manage process lifecycle per agent session
-- translate codex events -> normalized assistant stream
-- implement robust retry and “binary missing” errors
-
-## 4.3 `ClaudeCliAdapter`
-
-File:
-
-- `app/runtime/providers/adapters/claude-cli-adapter.ts`
-
-Implementation approach:
-
-- support preferred Claude CLI invocation/session mode available in your environment
-- parse streaming/stdout events to text deltas
-- add cancellation + process cleanup
-
----
-
-## Phase 5 — Agent Session Hooks
-
-### Modify `app/runtime/agent-session.ts`
-
-Add lifecycle hooks to call provider service:
-
-1. On model change to non-adapter provider:
-   - stop old adapter session handle (if exists).
-2. On user interrupt/steer path:
-   - call `providerService.interrupt(...)` when current provider is adapter-backed.
-3. On session shutdown:
-   - `providerService.stopSession(...)`.
-
-Goal: no orphan subprocesses and predictable cancellation.
-
----
-
-## Phase 6 — CLI UX and Login Surface
-
-### Modify `app/command-line/login-handler.ts`
-
-- include adapter providers only if they actually support login.
-- for `external-cli` auth mode, show clear message:
-  - “Authenticate using provider CLI command (e.g., `claude login`, `codex login`)”
-
-### Modify `app/command-line/list-models.ts` (optional enhancement)
-
-- show runtime-backed providers even without API keys when `authMode=external-cli` and health check passes.
-
----
-
-## Phase 7 — Tests
-
-Add tests in:
-
-- `tests/runtime/providers/*.test.ts`
-- `tests/runtime/model-registry*.test.ts`
-- `tests/runtime/sdk*.test.ts`
-
-### Required coverage
-
-1. Routing: adapter provider uses `ProviderService`, others use `streamSimple`.
-2. Validation: runtime external providers do not require apiKey/oauth.
-3. Persistence: provider runtime custom entry is written and restored.
-4. Interrupt/shutdown: child process cleanup runs.
-5. Error handling: binary missing, startup failure, malformed stream.
-
----
-
-## Phase 8 — Rollout Strategy
-
-1. Ship behind env flag:
-   - `INDUSAGI_ENABLE_PROVIDER_ADAPTERS=1`
-2. Enable only `indusagi-cli` adapter first.
-3. Then enable `codex-cli` and `claude-cli` after integration tests pass.
-4. Remove flag when stable.
-
----
-
-## Event Normalization Rules
-
-All adapters must normalize to one contract:
-
-1. `pushStart(output)`
-2. `pushTextStart(index, output)` once
-3. `pushTextDelta(index, delta, output)` many times
-4. `pushTextEnd(index, finalText, output)` once
-5. `pushDone(stopReason, output)` once
-6. `pushError(...)` on failure path
-
-Non-text native events (approvals/tool telemetry) should be mapped to session custom entries first, then surfaced in UI incrementally.
-
----
-
-## Risks and Mitigations
-
-1. **Provider protocol drift** (CLI output formats change)
-   - Mitigation: adapter-level parsers with golden tests.
-
-2. **Process leaks**
-   - Mitigation: strict stop/timeout/SIGKILL policy in provider service.
-
-3. **Auth ambiguity for external CLI**
-   - Mitigation: explicit `authMode=external-cli` + health checks + clear UX copy.
-
-4. **Session mismatch on restore**
-   - Mitigation: store adapter/model/provider in custom entry and validate before restore.
-
----
-
-## Definition of Done
-
-- [ ] New provider runtime module exists with registry/service/adapters.
-- [ ] `sdk.ts` routes adapter providers through provider service.
-- [ ] `model-registry.ts` supports runtime metadata and external-cli auth mode.
-- [ ] Adapter session metadata persisted and restorable.
-- [ ] `indusagi-cli` adapter fully working via RPC.
-- [ ] `codex-cli` and `claude-cli` adapters pass smoke tests.
-- [ ] No regressions for existing API providers.
-
----
-
-## Recommended Execution Order (Practical)
-
-1. Build shared runtime module + routing.
-2. Implement `indusagi-cli` adapter first (uses existing RPC client).
-3. Add persistence + interruption handling.
-4. Implement `codex-cli` adapter.
-5. Implement `claude-cli` adapter.
-6. Harden tests and remove feature flag.

package/guides/SAME_TO_SAME_PARITY_REPORT.md

@@ -1,312 +0,0 @@
-# Same-to-Same Parity Report
-
-Reference: `/Users/varunisrani/indusagi-ts/new_indusagi_coding_agent/src`  
-Target: `/Users/varunisrani/indusagi-ts/indusagi-screth/src`
-
-## Executive Summary
-
-`indusagi-screth` is **not same-to-same** with `new_indusagi_coding_agent` yet.
-
-High-level status:
-- Reference source files: **172**
-- Target source files: **35**
-- Missing in target: **137**
-- Shared filenames: **35**
-- Target-only source files: **0**
-
-Current target is a **working subset/scaffold** with several important runtime pieces implemented, but it is still missing major feature areas from the reference repo:
-- full CLI/bootstrap flow
-- full session runtime and compaction system
-- full export-html pipeline
-- package discovery and package manager flow
-- full extension runtime wrappers
-- most interactive TUI component system
-- observability layer
-- many utility modules
-
-This report is file-wise and focuses on **what must be added or expanded in `indusagi-screth`** to reach same-to-same parity.
-
----
-
-## A. Missing Files in `indusagi-screth`
-
-These files exist in `new_indusagi_coding_agent/src` but do not exist in `indusagi-screth/src`.
-
-### A1. Root bootstrap
-- `src/migrations.ts` — add real migrations, deprecation warnings, and migration boot flow used by `main.ts`.
-
-### A2. CLI files
-- `src/cli/config-selector.ts` — add interactive config selection flow.
-- `src/cli/file-processor.ts` — add `@file` and image/file argument processing before prompting.
-- `src/cli/list-models.ts` — add real model listing UX and filtering.
-- `src/cli/session-picker.ts` — add resume/session picking flow.
-
-### A3. Core runtime files
-- `src/core/bash-executor.ts` — add bash execution subsystem with truncation, streaming, and abort support.
-- `src/core/discover-packages.ts` — add package discovery for resource/package loading.
-- `src/core/event-bus.ts` — add shared event bus used by resource loader and extensions.
-- `src/core/exec.ts` — add generic process execution wrapper and typed exec results.
-- `src/core/footer-data-provider.ts` — add footer/git/status data provider for interactive mode and extensions.
-- `src/core/index.ts` — add consolidated core exports.
-- `src/core/keybindings.ts` — add configurable keybinding manager for TUI actions.
-- `src/core/messages.ts` — add message conversion/helpers for LLM context and custom messages.
-- `src/core/model-resolver.ts` — add model scope resolution and initial model selection logic.
-- `src/core/package-manager.ts` — add package install/remove/list/update runtime and resource path metadata.
-- `src/core/subagents.ts` — add subagent definitions and task integration support.
-- `src/core/timings.ts` — add timings/benchmark instrumentation used in bootstrap.
-- `src/core/todo-store.ts` — add reusable todo store abstraction used by tools layer.
-
-### A4. Compaction subsystem
-- `src/core/compaction/branch-summarization.ts` — add abandoned-branch summarization logic.
-- `src/core/compaction/compaction.ts` — add full compaction pipeline.
-- `src/core/compaction/index.ts` — add compaction exports and orchestration.
-- `src/core/compaction/utils.ts` — add token estimation and helper utilities.
-
-### A5. HTML export subsystem
-- `src/core/export-html/ansi-to-html.ts` — add ANSI to HTML conversion.
-- `src/core/export-html/index.ts` — add session export entrypoint.
-- `src/core/export-html/template.css` — add export page styling.
-- `src/core/export-html/template.html` — add export HTML shell.
-- `src/core/export-html/template.js` — add export page behavior.
-- `src/core/export-html/tool-renderer.ts` — add tool output renderer for export.
-- `src/core/export-html/vendor/highlight.min.js` — add bundled syntax highlighter.
-- `src/core/export-html/vendor/marked.min.js` — add bundled markdown renderer.
-
-### A6. Extension runtime support
-- `src/core/extensions/index.ts` — add public exports and shared extension API surface.
-- `src/core/extensions/runner.ts` — add extension command/event runtime.
-- `src/core/extensions/wrapper.ts` — add tool wrapping and extension hook integration.
-
-### A7. Tool implementation files
-- `src/core/tools/bash.ts` — add local bash tool implementation parity.
-- `src/core/tools/bg-process.ts` — add background process tool/runtime.
-- `src/core/tools/edit-diff.ts` — add edit diff generation helpers.
-- `src/core/tools/edit.ts` — add local edit tool parity implementation.
-- `src/core/tools/find.ts` — add local find tool parity implementation.
-- `src/core/tools/grep.ts` — add local grep tool parity implementation.
-- `src/core/tools/ls.ts` — add local ls tool parity implementation.
-- `src/core/tools/path-utils.ts` — add path resolution helpers for tools.
-- `src/core/tools/read.ts` — add local read tool parity implementation.
-- `src/core/tools/registry.ts` — add tool registry metadata and listing helpers.
-- `src/core/tools/truncate.ts` — add truncation helpers and shared constants.
-- `src/core/tools/webfetch.ts` — add local webfetch tool parity implementation.
-- `src/core/tools/websearch.ts` — add local websearch tool parity implementation.
-- `src/core/tools/write.ts` — add local write tool parity implementation.
-
-### A8. Shared mode file
-- `src/modes/shared.ts` — add shared mode types/helpers.
-
-### A9. Interactive component system
-- `src/modes/interactive/components/armin.ts` — add startup/logo art component.
-- `src/modes/interactive/components/assistant-message.ts` — add assistant message rendering with markdown/thinking support.
-- `src/modes/interactive/components/bash-execution.ts` — add live bash execution UI.
-- `src/modes/interactive/components/bordered-loader.ts` — add bordered loading UI.
-- `src/modes/interactive/components/branch-summary-message.ts` — add branch summary message renderer.
-- `src/modes/interactive/components/compaction-summary-message.ts` — add compaction summary renderer.
-- `src/modes/interactive/components/config-selector.ts` — add config selector UI.
-- `src/modes/interactive/components/countdown-timer.ts` — add retry/timeout countdown UI.
-- `src/modes/interactive/components/custom-editor.ts` — add multiline editor with history/actions/autocomplete.
-- `src/modes/interactive/components/custom-message.ts` — add custom message display.
-- `src/modes/interactive/components/diff.ts` — add diff rendering UI.
-- `src/modes/interactive/components/dynamic-border.ts` — add dynamic border behavior.
-- `src/modes/interactive/components/extension-editor.ts` — add extension-provided editor support.
-- `src/modes/interactive/components/extension-input.ts` — add extension input UI.
-- `src/modes/interactive/components/extension-selector.ts` — add extension selection UI.
-- `src/modes/interactive/components/footer.ts` — add footer renderer.
-- `src/modes/interactive/components/index.ts` — add component exports.
-- `src/modes/interactive/components/keybinding-hints.ts` — add keybinding hint rendering.
-- `src/modes/interactive/components/login-dialog.ts` — add login dialog UI.
-- `src/modes/interactive/components/model-selector.ts` — add model selection dialog.
-- `src/modes/interactive/components/oauth-selector.ts` — add OAuth/account selection dialogs.
-- `src/modes/interactive/components/scoped-models-selector.ts` — add scoped models selector UI.
-- `src/modes/interactive/components/session-selector-search.ts` — add session search UI.
-- `src/modes/interactive/components/session-selector.ts` — add session picker UI.
-- `src/modes/interactive/components/settings-selector.ts` — add settings UI.
-- `src/modes/interactive/components/show-images-selector.ts` — add image display selection UI.
-- `src/modes/interactive/components/skill-invocation-message.ts` — add skill invocation renderer.
-- `src/modes/interactive/components/theme-selector.ts` — add theme selector UI.
-- `src/modes/interactive/components/thinking-selector.ts` — add thinking level selector UI.
-- `src/modes/interactive/components/tool-execution.ts` — add live tool execution renderer.
-- `src/modes/interactive/components/tree-selector.ts` — add session tree navigation UI.
-- `src/modes/interactive/components/user-message-selector.ts` — add user message selection UI.
-- `src/modes/interactive/components/user-message.ts` — add user message renderer.
-- `src/modes/interactive/components/visual-truncate.ts` — add visual truncation helper.
-
-### A10. Theme assets
-- `src/modes/interactive/theme/dark.json` — add bundled dark theme.
-- `src/modes/interactive/theme/light.json` — add bundled light theme.
-- `src/modes/interactive/theme/theme-schema.json` — add theme schema validation.
-
-### A11. Observability subsystem
-- `src/observability/core/config.ts` — add observability config.
-- `src/observability/core/event-bus.ts` — add observability event bus.
-- `src/observability/core/index.ts` — add observability exports.
-- `src/observability/core/observability.ts` — add observability runtime.
-- `src/observability/core/span.ts` — add tracing spans.
-- `src/observability/core/tracer.ts` — add tracer implementation.
-- `src/observability/core/types.ts` — add observability types.
-- `src/observability/exporters/base-exporter.ts` — add exporter base type.
-- `src/observability/exporters/console-exporter.ts` — add console exporter.
-- `src/observability/exporters/file-exporter.ts` — add file exporter.
-- `src/observability/exporters/index.ts` — add exporter exports.
-- `src/observability/exporters/langfuse-exporter.ts` — add Langfuse exporter.
-- `src/observability/exporters/sentry-exporter.ts` — add Sentry exporter.
-
-### A12. Utility files
-- `src/utils/array.ts` — add array helpers.
-- `src/utils/changelog.ts` — add changelog parsing helpers.
-- `src/utils/clipboard-image.ts` — add clipboard image support.
-- `src/utils/clipboard.ts` — add clipboard support.
-- `src/utils/color-formatter.ts` — add terminal color formatting utilities.
-- `src/utils/data-transformer.ts` — add data transform helpers.
-- `src/utils/date-formatter.ts` — add date formatting utilities.
-- `src/utils/error-handler.ts` — add shared error helpers.
-- `src/utils/file-operations.ts` — add common file operation helpers.
-- `src/utils/git.ts` — add git detection/format helpers.
-- `src/utils/image-convert.ts` — add image conversion helpers.
-- `src/utils/image-resize.ts` — add image resize helpers.
-- `src/utils/json-formatter.ts` — add JSON formatting helpers.
-- `src/utils/logger.ts` — add logging helpers.
-- `src/utils/markdown-formatter.ts` — add markdown formatting helpers.
-- `src/utils/mime.ts` — add mime detection helpers.
-- `src/utils/path-validator.ts` — add safe path validation helpers.
-- `src/utils/photon.ts` — add photon/image terminal helpers.
-- `src/utils/shell.ts` — add shell helpers.
-- `src/utils/sleep.ts` — add sleep helper.
-- `src/utils/string-formatter.ts` — add string formatting helpers.
-- `src/utils/tools-manager.ts` — add external tool discovery helpers.
-- `src/utils/type-guards.ts` — add common type guards.
-
-### A13. Utility tests/docs present in reference only
-- `src/utils/__tests__/DELIVERY_SUMMARY.txt`
-- `src/utils/__tests__/README.md`
-- `src/utils/__tests__/TEST_SUMMARY.md`
-- `src/utils/__tests__/array.test.ts`
-- `src/utils/__tests__/color-formatter.test.ts`
-- `src/utils/__tests__/data-transformer.test.ts`
-- `src/utils/__tests__/date-formatter.test.ts`
-- `src/utils/__tests__/error-handler.test.ts`
-- `src/utils/__tests__/file-operations.test.ts`
-- `src/utils/__tests__/frontmatter.test.ts`
-- `src/utils/__tests__/json-formatter.test.ts`
-- `src/utils/__tests__/logger.test.ts`
-- `src/utils/__tests__/markdown-formatter.test.ts`
-- `src/utils/__tests__/path-validator.test.ts`
-- `src/utils/__tests__/string-formatter.test.ts`
-- `src/utils/__tests__/type-guards.test.ts`
-
----
-
-## B. Shared Files With Major Feature Gaps
-
-These files exist in both trees, but `indusagi-screth` is still reduced compared with the reference implementation.
-
-### B1. CLI / entry files
-- `src/cli.ts` — target is functional but only a thin CLI entry; keep aligned with reference startup conventions.
-- `src/cli/args.ts` — target supports many flags, but is still missing reference-level validation, export flag handling, richer help text, and tighter integration with `allTools` metadata.
-- `src/cli/login-handler.ts` — target handles basic login/logout/list, but lacks reference-level validation, richer error classes, provider help UX, and broader account-management behavior.
-- `src/config.ts` — mostly present, but verify full path helper parity and bundled asset assumptions against reference.
-- `src/index.ts` — target exports only a small subset; add the broader public API surface from reference (compaction, extension APIs, hooks, package manager, SDK types, session manager types, modes, etc.).
-- `src/main.ts` — target is still a scaffold-style bootstrap. Add config selection, file processing, model listing, session picker, package commands, export flow, scoped model resolution, migrations integration, theme init/shutdown, package discovery, and richer session-manager construction.
-
-### B2. Core runtime
-- `src/core/agent-session.ts` — target is the biggest runtime gap. Add full tool execution orchestration, bash execution pipeline, prompt-template/skill expansion, extension binding, session switching, session stats, auto-compaction, branch summarization, auto-retry, export support, richer event handling, and extension lifecycle hooks.
-- `src/core/auth-storage.ts` — target supports basic stored auth, but still needs full validation/UX parity and any reference edge-case handling around migration, provider/account behavior, and credential refresh nuances.
-- `src/core/diagnostics.ts` — target only has a tiny diagnostics shape; add the richer collision/diagnostic helpers used across resources and UI.
-- `src/core/model-registry.ts` — target supports core registry behavior, but still needs reference-level model lookup breadth, API key logic, enabled-model filtering, custom provider/model loading, and richer account/model selection behavior.
-- `src/core/prompt-templates.ts` — target loads prompt templates, but still needs fuller parsing, validation, formatting, and command-expansion behavior from reference.
-- `src/core/resource-loader.ts` — target is one of the stronger files, but still lacks the full package-manager/event-bus/settings integration, package filtering, override hooks, and richer source resolution behavior from reference.
-- `src/core/sdk.ts` — target creates working sessions, but still needs full reference-level model resolution, message conversion, extension wrapping, package/resource/session restoration rules, MCP hookup behavior, and tighter manager orchestration.
-- `src/core/session-manager.ts` — target is only a re-export wrapper. For same-to-same parity, add the local implementation and any reference-specific behavior, helpers, and exports.
-- `src/core/settings-manager.ts` — target omits many reference settings areas: compaction, branch summaries, terminal/image display, packages, extensions/hooks/skills/prompts/themes arrays, skill command enablement, shell path, changelog collapse, double-escape action, editor padding, hardware cursor, markdown settings, and more setters/getters.
-- `src/core/skills.ts` — target loads skills, but still needs full formatting, validation, and any reference-specific behavior around root-vs-nested skills and command registration.
-- `src/core/system-prompt.ts` — target prompt builder is much smaller. Add full tool guidance, docs/examples path references, todo/task sections, subagent descriptions, timestamp formatting, and custom prompt augmentation behavior from reference.
-- `src/core/task-session-manager.ts` — target task session store is basic; add deeper subagent runtime/session behavior from reference.
-
-### B3. Extension / hook system
-- `src/core/extensions/loader.ts` — target loads extensions, but without the full surrounding runner/wrapper/index runtime and narrower API support.
-- `src/core/extensions/types.ts` — target types are heavily reduced. Add full extension UI context, command context, shortcut, tool wrapping, session lifecycle, bash event, input event, compaction, rendering, and action types from reference.
-- `src/core/hooks/index.ts` — target exports only a subset; add the full hook type export surface.
-- `src/core/hooks/loader.ts` — target is smaller; add full discovery/loading/error semantics used by reference.
-- `src/core/hooks/runner.ts` — close structurally, but verify exact parity with generic typing and hook error behavior.
-- `src/core/hooks/types.ts` — target is minimal; add the full hook schema surface from reference (`chat.headers`, `chat.params`, tool before/after, command before, session compacting, text complete, event hooks, etc.).
-
-### B4. Tools layer
-- `src/core/tools/index.ts` — target re-exports many `indusagi/agent` tools, but same-to-same parity needs the full local tool module layout, registry metadata, background process tool, truncate/path-utils helpers, and exact reference composition behavior.
-- `src/core/tools/task.ts` — target works, but still needs exact reference behavior and full task-tool surface.
-- `src/core/tools/todo.ts` — target is functional, but should align with the reference todo-store abstraction and exact session-backed semantics.
-
-### B5. Modes
-- `src/modes/index.ts` — target exports fewer mode/runtime types than reference.
-- `src/modes/interactive/interactive-mode.ts` — target is a readline REPL, not the reference TUI. Add full TUI layout, keyboard handling, selectors, widgets, streaming tool panes, footer, theme integration, slash command autocomplete, extension UI context, changelog/startup UI, and richer session controls.
-- `src/modes/interactive/theme/theme.ts` — target only loads JSON. Add full theme resolution, global registration, schema validation, terminal color handling, hot reload, markdown/editor theme helpers, and bundled theme integration.
-- `src/modes/print-mode.ts` — target supports basic text/json output, but lacks reference-level error handling, extension binding, session action hooks, and richer output semantics.
-- `src/modes/rpc/rpc-client.ts` — target is a minimal process wrapper; add full typed request correlation, event handling, lifecycle management, and helper methods from reference.
-- `src/modes/rpc/rpc-mode.ts` — target supports a smaller RPC command set. Add full JSON-RPC behavior, extension UI request/response bridge, additional commands, shutdown handling, and richer state reporting.
-- `src/modes/rpc/rpc-types.ts` — target types are very small; add the full command/response/event protocol surface.
-
-### B6. Utility file
-- `src/utils/frontmatter.ts` — target only provides a smaller parser. Add full frontmatter helpers and reference-level utility behavior/tests.
-
----
-
-## C. Target-Only Files
-
-None. `indusagi-screth/src` is currently a subset of `new_indusagi_coding_agent/src`, not a divergent tree.
-
----
-
-## D. Highest-Priority Files To Add/Expand Next
-
-If the goal is **same-to-same all features**, work in this order:
-
-1. `src/main.ts`
-2. `src/core/agent-session.ts`
-3. `src/core/session-manager.ts`
-4. `src/core/messages.ts`
-5. `src/core/model-resolver.ts`
-6. `src/core/settings-manager.ts`
-7. `src/core/bash-executor.ts`
-8. `src/core/compaction/*`
-9. `src/core/package-manager.ts`
-10. `src/core/discover-packages.ts`
-11. `src/core/extensions/index.ts`
-12. `src/core/extensions/runner.ts`
-13. `src/core/extensions/wrapper.ts`
-14. `src/modes/interactive/interactive-mode.ts`
-15. `src/modes/interactive/components/*`
-16. `src/modes/interactive/theme/dark.json`
-17. `src/modes/interactive/theme/light.json`
-18. `src/modes/interactive/theme/theme-schema.json`
-19. `src/modes/rpc/rpc-mode.ts`
-20. `src/modes/rpc/rpc-client.ts`
-21. `src/modes/rpc/rpc-types.ts`
-22. `src/modes/print-mode.ts`
-23. `src/core/export-html/*`
-24. `src/cli/file-processor.ts`
-25. `src/cli/list-models.ts`
-26. `src/cli/session-picker.ts`
-27. `src/cli/config-selector.ts`
-28. `src/core/tools/*` missing local tool modules
-29. `src/observability/*`
-30. `src/utils/*` missing helper modules/tests
-
----
-
-## E. Final Verdict
-
-`indusagi-screth` is **not ready for same-to-same parity** with `new_indusagi_coding_agent`.
-
-What is true right now:
-- it builds
-- it runs basic text/json/rpc flows
-- it has working hooks/skills loading
-- it has a subset of the runtime implemented
-
-What is not true yet:
-- it does **not** contain the full file set
-- it does **not** contain the full interactive TUI system
-- it does **not** contain the full compaction/export/package/observability stack
-- several shared files are still reduced implementations
-
-If the requirement is **"same to same all feature"**, then the missing files and shared-file gaps above still need to be implemented.