corydora 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+All notable changes to Corydora are documented in this file.
+
+## [0.1.0] - 2026-03-22
+
+### Added
+
+- Initial public baseline for the Corydora CLI project
+- Provider-neutral overnight code scrubbing workflow and task queues
+- Built-in agents, runtime adapters, CI, docs, and npm publishing scaffolding

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 James Lee Baker
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the 'Software'), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,165 @@
+# Corydora
+
+[![Status: Alpha](https://img.shields.io/badge/status-alpha-orange.svg)](#project-status)
+[![CI](https://github.com/glorioustephan/corydora/actions/workflows/ci.yml/badge.svg)](https://github.com/glorioustephan/corydora/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/corydora.svg)](https://www.npmjs.com/package/corydora)
+[![npm downloads](https://img.shields.io/npm/dm/corydora.svg)](https://www.npmjs.com/package/corydora)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+[![Docs](https://img.shields.io/badge/docs-vitepress-7c3aed.svg)](https://glorioustephan.github.io/corydora/)
+
+<p align="center">
+  <img src="./logo.webp" alt="Corydora" width="320px" />
+</p>
+
+Corydora is a globally installable CLI for overnight AI-assisted codebase cleanup. It detects the
+AI runtimes available in a project, creates a `.corydora.json` config plus a `.corydora/` working
+area, scans files in isolated passes, renders category-specific task queues, and applies small
+safe fixes one task at a time on a dedicated branch or worktree.
+
+## Project Status
+
+Corydora is currently in **alpha**. The CLI, scheduler, queue/state model, provider adapter layer,
+and release workflows are implemented, but this is still an early open-source package and the
+runtime matrix is not equally mature across providers.
+
+### Current readiness
+
+- Core CLI commands are implemented and covered by automated tests.
+- CI is configured for `lint`, `format:check`, `typecheck`, `test`, and `build` on every push and
+  pull request to `main`.
+- The package supports Node `20.19.0` or newer.
+- CI, publish, and local version-manager hints are standardized on Node `24.14.0`.
+- npm publishing is configured through GitHub Actions using **npm trusted publishing** and GitHub
+  OIDC.
+- CI currently runs on `ubuntu-latest` only; a multi-OS matrix is not in place yet.
+- CLI-backed runtimes (`claude-cli`, `codex-cli`, `gemini-cli`) support native agent/tool editing.
+- API-backed runtimes currently use a constrained JSON rewrite mode that is best suited to
+  single-file tasks.
+- Background tmux runs on macOS use `caffeinate -i` when available so overnight sessions can keep running with the display asleep.
+- Runtime request size, timeout, and retry budgets are configurable in `.corydora.json`.
+- Provider smoke tests exist but are opt-in because they depend on local vendor auth and binaries.
+- Coverage reporting and coverage thresholds are not wired into CI yet.
+
+### Testability today
+
+- Unit coverage: config parsing, queue state, scheduler selection, fake runtime.
+- Integration coverage: `init`, `doctor`, `run --dry-run`, and a full fake-provider run.
+- Manual smoke path: build the CLI and run it against a temporary git fixture.
+- Real-provider validation: gated behind `CORYDORA_ENABLE_PROVIDER_SMOKE=1`.
+
+## Install
+
+```bash
+pnpm add -g corydora
+```
+
+## Quickstart
+
+```bash
+corydora
+corydora init
+corydora doctor
+corydora run --dry-run
+corydora run --background
+```
+
+## Development
+
+```bash
+fnm use
+# or: nvm use
+pnpm install
+pnpm lint
+pnpm format:check
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm pack:preview
+```
+
+The main verification surface right now is:
+
+- `pnpm lint`
+- `pnpm format:check`
+- `pnpm typecheck`
+- `pnpm test`
+- `pnpm build`
+- `pnpm pack:preview`
+
+`pnpm check` runs the core verification steps and is also used by `prepublishOnly`. `pnpm
+pack:preview` produces the exact npm tarball shape that CI uploads as a workflow artifact.
+
+### Commit workflow
+
+- `pnpm commit` launches Commitizen with the conventional changelog prompt.
+- Conventional Commit types drive semantic versioning through release-please:
+  `fix` => patch, `feat` => minor, and `!` / `BREAKING CHANGE` => major.
+- Release PRs update `package.json` and `CHANGELOG.md`; you no longer need to push version tags by
+  hand.
+- ESLint uses a flat config in `eslint.config.mjs`.
+- Prettier uses `prettier.config.mjs` and `.editorconfig`.
+
+## Command Surface
+
+- `corydora` launches `init` when `.corydora.json` is missing, otherwise opens a short interactive menu.
+- `corydora init` creates `.corydora.json`, `.corydora/`, markdown queue files, and a local env template.
+- `corydora run` starts a rolling scan/fix loop with resumable state.
+- `corydora status` shows the current or most recent run state.
+- `corydora attach` attaches to a tmux-backed background run.
+- `corydora stop` requests a graceful stop and kills the tmux session when one exists.
+- `corydora doctor` reports runtime availability and auth/config hints.
+- `corydora agents list` shows builtin and imported agents.
+- `corydora agents import <dir>` imports external agent metadata into `.corydora/agents/`.
+- `corydora config validate` validates `.corydora.json`.
+
+## Docs
+
+Full documentation is available at **[glorioustephan.github.io/corydora](https://glorioustephan.github.io/corydora/)**.
+
+- [Getting Started](https://glorioustephan.github.io/corydora/getting-started)
+- [Quickstart](https://glorioustephan.github.io/corydora/quickstart)
+- [CLI Reference](https://glorioustephan.github.io/corydora/cli-reference)
+- [Configuration](https://glorioustephan.github.io/corydora/configuration)
+- [Providers](https://glorioustephan.github.io/corydora/providers/)
+- [Agent Catalog](https://glorioustephan.github.io/corydora/agents/)
+- [Security Model](https://glorioustephan.github.io/corydora/security)
+- [How It Works](https://glorioustephan.github.io/corydora/how-it-works)
+
+## CI/CD
+
+Corydora ships two GitHub Actions workflows:
+
+- `ci.yml`: runs `pnpm install --frozen-lockfile`, `pnpm lint`, `pnpm format:check`, `pnpm
+typecheck`, `pnpm test`, and `pnpm build` on pushes and pull requests to `main`, then uploads an
+  npm tarball preview artifact.
+- `publish.yml`: runs release-please on pushes to `main`, opens or updates a release PR from
+  Conventional Commits, and publishes to npm only when merging that release PR creates a release.
+
+### Trusted publishing requirements
+
+Before the first public release, configure npm trusted publishing for this repository:
+
+1. Create the GitHub repository that will host Corydora.
+2. Confirm the `repository`, `homepage`, and `bugs` fields in `package.json` match the real repo.
+3. If `corydora` does not exist on npm yet, publish it once manually from your user account so the
+   package page and settings exist.
+4. In npm package settings for `corydora`, add a trusted publisher for GitHub Actions with workflow
+   filename `publish.yml`.
+5. Optionally add a `RELEASE_PLEASE_TOKEN` GitHub secret if you want bot-created release PRs to
+   trigger other workflows normally.
+6. Optionally protect the `npm` GitHub environment before enabling publish.
+7. After trusted publishing is configured, publish future releases by merging the release PR that
+   release-please opens against `main`.
+
+Trusted publishing also requires GitHub-hosted runners, Node `22.14.0` or newer, and npm CLI
+`11.5.1` or newer. The publish workflow pins Node `24.14.0` and upgrades npm explicitly before it
+calls `npm publish`.
+
+## Notes
+
+- Secrets never belong in `.corydora.json`.
+- `.corydora/.env.local` is ignored by default.
+- Markdown queue files are projections of machine state in `.corydora/state/`.
+- The root `CHANGELOG.md` is the canonical release history and is maintained by release-please.
+- The npm publish workflow assumes GitHub-hosted runners, which is also what npm trusted publishing
+  currently requires.

package/dist/agents/builtin-agents.d.ts

@@ -0,0 +1,2 @@
+import type { AgentDefinition } from '../types/domain.js';
+export declare const BUILTIN_AGENTS: AgentDefinition[];

package/dist/agents/builtin-agents.js

@@ -0,0 +1,75 @@
+export const BUILTIN_AGENTS = [
+    {
+        id: 'bug-investigator',
+        label: 'Bug Investigator',
+        description: 'Find correctness bugs and concrete failure paths in one file at a time.',
+        categories: ['bugs'],
+        techLenses: ['typescript', 'refactoring'],
+        prompt: 'Focus on concrete bugs, edge-case failures, and misleading behavior. Prefer narrow fixes and testable evidence.',
+        source: 'builtin',
+    },
+    {
+        id: 'performance-engineer',
+        label: 'Performance Engineer',
+        description: 'Find unnecessary renders, repeated work, and heavy I/O hot spots.',
+        categories: ['performance'],
+        techLenses: ['typescript', 'react', 'nextjs', 'electron'],
+        prompt: 'Look for measurable performance improvements. Prefer small changes with clear user-facing impact.',
+        source: 'builtin',
+    },
+    {
+        id: 'test-hardener',
+        label: 'Test Hardener',
+        description: 'Identify missing tests, flaky patterns, and weak validation.',
+        categories: ['tests'],
+        techLenses: ['typescript', 'react', 'nextjs', 'node-cli'],
+        prompt: 'Focus on observable behavior and missing safety nets. Recommend the narrowest test or validation addition.',
+        source: 'builtin',
+    },
+    {
+        id: 'todo-triager',
+        label: 'Todo Triager',
+        description: 'Turns comments, skipped code paths, and deferred work into concrete tasks.',
+        categories: ['todo'],
+        techLenses: ['typescript', 'refactoring'],
+        prompt: 'Convert vague technical debt into actionable, scoped tasks. Avoid broad rewrites.',
+        source: 'builtin',
+    },
+    {
+        id: 'feature-scout',
+        label: 'Feature Scout',
+        description: 'Identifies small feature opportunities that fit the existing architecture.',
+        categories: ['features'],
+        techLenses: ['react', 'nextjs', 'node-cli', 'electron'],
+        prompt: 'Propose only incremental product improvements. Features are queued by default and not auto-fixed unless enabled.',
+        source: 'builtin',
+    },
+    {
+        id: 'security-auditor',
+        label: 'Security Auditor',
+        description: 'Looks for frontend and backend security issues with concrete exploit paths.',
+        categories: ['bugs'],
+        techLenses: ['security', 'typescript', 'react', 'nextjs', 'node-cli'],
+        prompt: 'Prioritize trust boundaries, unsafe input handling, auth assumptions, and exploitable patterns.',
+        source: 'builtin',
+    },
+    {
+        id: 'database-reviewer',
+        label: 'Database Reviewer',
+        description: 'Finds risky queries, schema drift issues, and performance bottlenecks around data access.',
+        categories: ['bugs', 'performance'],
+        techLenses: ['database', 'typescript', 'node-cli'],
+        prompt: 'Focus on concrete query risks, indexing concerns, and data-layer correctness.',
+        source: 'builtin',
+    },
+    {
+        id: 'refactoring-engineer',
+        label: 'Refactoring Engineer',
+        description: 'Finds low-risk structural cleanups that make future work easier.',
+        categories: ['todo', 'performance', 'tests'],
+        techLenses: ['refactoring', 'typescript'],
+        prompt: 'Prefer low-risk structure improvements that reduce complexity without changing behavior.',
+        source: 'builtin',
+    },
+];
+//# sourceMappingURL=builtin-agents.js.map

package/dist/agents/builtin-agents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtin-agents.js","sourceRoot":"","sources":["../../src/agents/builtin-agents.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAsB;IAC/C;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,yEAAyE;QACtF,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QACzC,MAAM,EACJ,iHAAiH;QACnH,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,mEAAmE;QAChF,UAAU,EAAE,CAAC,aAAa,CAAC;QAC3B,UAAU,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACzD,MAAM,EACJ,mGAAmG;QACrG,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8DAA8D;QAC3E,UAAU,EAAE,CAAC,OAAO,CAAC;QACrB,UAAU,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACzD,MAAM,EACJ,4GAA4G;QAC9G,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,4EAA4E;QACzF,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,CAAC,YAAY,EAAE,aAAa,CAAC;QACzC,MAAM,EAAE,mFAAmF;QAC3F,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,eAAe;QACnB,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,4EAA4E;QACzF,UAAU,EAAE,CAAC,UAAU,CAAC;QACxB,UAAU,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,CAAC;QACvD,MAAM,EACJ,kHAAkH;QACpH,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,kBAAkB;QACzB,WAAW,EAAE,6EAA6E;QAC1F,UAAU,EAAE,CAAC,MAAM,CAAC;QACpB,UAAU,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,CAAC;QACrE,MAAM,EACJ,iGAAiG;QACnG,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,2FAA2F;QAC7F,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;QACnC,UAAU,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC;QAClD,MAAM,EAAE,+EAA+E;QACvF,MAAM,EAAE,SAAS;KAClB;IACD;QACE,EAAE,EAAE,sBAAsB;QAC1B,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EAAE,kEAAkE;QAC/E,UAAU,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC;QAC5C,UAAU,EAAE,CAAC,aAAa,EAAE,YAAY,CAAC;QACzC,MAAM,EACJ,0FAA0F;QAC5F,MAAM,EAAE,SAAS;KAClB;CACF,CAAC"}

package/dist/agents/catalog.d.ts

@@ -0,0 +1,4 @@
+import type { AgentDefinition, ImportedAgentRecord, CorydoraConfig } from '../types/domain.js';
+export declare function loadImportedAgents(projectRoot: string, config: CorydoraConfig): Promise<ImportedAgentRecord[]>;
+export declare function listAgents(projectRoot: string, config: CorydoraConfig): Promise<AgentDefinition[]>;
+export declare function importAgentsFromDirectory(projectRoot: string, config: CorydoraConfig, sourceDirectory: string): Promise<ImportedAgentRecord[]>;

package/dist/agents/catalog.js

@@ -0,0 +1,49 @@
+import { readdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { basename, extname, resolve } from 'node:path';
+import { BUILTIN_AGENTS } from './builtin-agents.js';
+import { parseMarkdownFrontmatter } from './frontmatter.js';
+function importedAgentsPath(projectRoot, config) {
+    return resolve(projectRoot, config.paths.agentsDir, 'imported-agents.json');
+}
+export async function loadImportedAgents(projectRoot, config) {
+    const filePath = importedAgentsPath(projectRoot, config);
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const raw = await readFile(filePath, 'utf8');
+    const parsed = JSON.parse(raw);
+    return Array.isArray(parsed.agents) ? parsed.agents : [];
+}
+export async function listAgents(projectRoot, config) {
+    const imported = await loadImportedAgents(projectRoot, config);
+    return [...BUILTIN_AGENTS, ...imported];
+}
+export async function importAgentsFromDirectory(projectRoot, config, sourceDirectory) {
+    const entries = await readdir(sourceDirectory, { withFileTypes: true });
+    const imported = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || extname(entry.name) !== '.md') {
+            continue;
+        }
+        const absolutePath = resolve(sourceDirectory, entry.name);
+        const raw = await readFile(absolutePath, 'utf8');
+        const parsed = parseMarkdownFrontmatter(raw);
+        const fallbackId = basename(entry.name, '.md');
+        imported.push({
+            id: parsed.attributes.name ?? fallbackId,
+            label: parsed.attributes.name ?? fallbackId,
+            description: parsed.attributes.description ?? 'Imported external agent metadata.',
+            categories: ['todo'],
+            techLenses: ['refactoring'],
+            prompt: parsed.body.trim().slice(0, 4000),
+            source: 'imported',
+            originalPath: absolutePath,
+            importedAt: new Date().toISOString(),
+        });
+    }
+    const filePath = importedAgentsPath(projectRoot, config);
+    await writeFile(filePath, `${JSON.stringify({ agents: imported }, null, 2)}\n`, 'utf8');
+    return imported;
+}
+//# sourceMappingURL=catalog.js.map

package/dist/agents/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/agents/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,SAAS,kBAAkB,CAAC,WAAmB,EAAE,MAAsB;IACrE,OAAO,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,sBAAsB,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuC,CAAC;IACrE,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC/D,OAAO,CAAC,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,MAAsB,EACtB,eAAuB;IAEvB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC;YACrD,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE/C,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,UAAU;YACxC,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,IAAI,UAAU;YAC3C,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC,WAAW,IAAI,mCAAmC;YACjF,UAAU,EAAE,CAAC,MAAM,CAAC;YACpB,UAAU,EAAE,CAAC,aAAa,CAAC;YAC3B,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;YACzC,MAAM,EAAE,UAAU;YAClB,YAAY,EAAE,YAAY;YAC1B,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxF,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/agents/frontmatter.d.ts

@@ -0,0 +1,5 @@
+export interface ParsedFrontmatter {
+    attributes: Record<string, string>;
+    body: string;
+}
+export declare function parseMarkdownFrontmatter(raw: string): ParsedFrontmatter;

package/dist/agents/frontmatter.js

@@ -0,0 +1,30 @@
+export function parseMarkdownFrontmatter(raw) {
+    const match = raw.match(/^---\s*\n([\s\S]*?)\n---\s*\n?([\s\S]*)$/);
+    if (!match) {
+        return {
+            attributes: {},
+            body: raw,
+        };
+    }
+    const [, frontmatterBlock = '', body = ''] = match;
+    const attributes = frontmatterBlock.split('\n').reduce((acc, line) => {
+        const separatorIndex = line.indexOf(':');
+        if (separatorIndex === -1) {
+            return acc;
+        }
+        const key = line.slice(0, separatorIndex).trim();
+        const value = line
+            .slice(separatorIndex + 1)
+            .trim()
+            .replace(/^["']|["']$/g, '');
+        if (key.length > 0 && value.length > 0) {
+            acc[key] = value;
+        }
+        return acc;
+    }, {});
+    return {
+        attributes,
+        body,
+    };
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/agents/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/agents/frontmatter.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IACpE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,UAAU,EAAE,EAAE;YACd,IAAI,EAAE,GAAG;SACV,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,EAAE,gBAAgB,GAAG,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC;IACnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAyB,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QAC3F,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;YAC1B,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,IAAI,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI;aACf,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC;aACzB,IAAI,EAAE;aACN,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QAC/B,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,UAAU;QACV,IAAI;KACL,CAAC;AACJ,CAAC"}

package/dist/commands/agents-import.d.ts

@@ -0,0 +1,2 @@
+import type { Ui } from '../ui/output.js';
+export declare function runAgentsImportCommand(projectRoot: string, sourceDirectory: string, json: boolean, ui: Ui): Promise<void>;

package/dist/commands/agents-import.js

@@ -0,0 +1,12 @@
+import { importAgentsFromDirectory } from '../agents/catalog.js';
+import { loadRequiredConfig } from './helpers.js';
+export async function runAgentsImportCommand(projectRoot, sourceDirectory, json, ui) {
+    const config = await loadRequiredConfig(projectRoot);
+    const imported = await importAgentsFromDirectory(projectRoot, config, sourceDirectory);
+    if (json) {
+        ui.printJson(imported);
+        return;
+    }
+    ui.success(`Imported ${imported.length} agent(s) from ${sourceDirectory}.`);
+}
+//# sourceMappingURL=agents-import.js.map

package/dist/commands/agents-import.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-import.js","sourceRoot":"","sources":["../../src/commands/agents-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,eAAuB,EACvB,IAAa,EACb,EAAM;IAEN,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,yBAAyB,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;IAEvF,IAAI,IAAI,EAAE,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO;IACT,CAAC;IAED,EAAE,CAAC,OAAO,CAAC,YAAY,QAAQ,CAAC,MAAM,kBAAkB,eAAe,GAAG,CAAC,CAAC;AAC9E,CAAC"}

package/dist/commands/agents-list.d.ts

@@ -0,0 +1,2 @@
+import type { Ui } from '../ui/output.js';
+export declare function runAgentsListCommand(projectRoot: string, json: boolean, ui: Ui): Promise<void>;

package/dist/commands/agents-list.js

@@ -0,0 +1,26 @@
+import { BUILTIN_AGENTS } from '../agents/builtin-agents.js';
+import { listAgents } from '../agents/catalog.js';
+import { loadRequiredConfig } from './helpers.js';
+export async function runAgentsListCommand(projectRoot, json, ui) {
+    try {
+        const config = await loadRequiredConfig(projectRoot);
+        const agents = await listAgents(projectRoot, config);
+        if (json) {
+            ui.printJson(agents);
+            return;
+        }
+        for (const agent of agents) {
+            ui.info(`${agent.id} [${agent.source}] -> ${agent.description}`);
+        }
+    }
+    catch {
+        if (json) {
+            ui.printJson(BUILTIN_AGENTS);
+            return;
+        }
+        for (const agent of BUILTIN_AGENTS) {
+            ui.info(`${agent.id} [builtin] -> ${agent.description}`);
+        }
+    }
+}
+//# sourceMappingURL=agents-list.js.map

package/dist/commands/agents-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents-list.js","sourceRoot":"","sources":["../../src/commands/agents-list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,IAAa,EACb,EAAM;IAEN,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,KAAK,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,IAAI,EAAE,CAAC;YACT,EAAE,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,EAAE,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,EAAE,iBAAiB,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/commands/attach.d.ts

@@ -0,0 +1 @@
+export declare function runAttachCommand(projectRoot: string): Promise<void>;

package/dist/commands/attach.js

@@ -0,0 +1,16 @@
+import { loadRunState } from '../queue/state.js';
+import { loadRequiredConfig } from './helpers.js';
+import { attachToSession, tmuxSessionExists } from '../runtime/tmux.js';
+export async function runAttachCommand(projectRoot) {
+    const config = await loadRequiredConfig(projectRoot);
+    const runState = await loadRunState(projectRoot, config);
+    const sessionName = runState?.background?.sessionName;
+    if (!sessionName) {
+        throw new Error('No tmux-backed Corydora session is recorded for this project.');
+    }
+    if (!tmuxSessionExists(sessionName)) {
+        throw new Error(`tmux session "${sessionName}" is not running.`);
+    }
+    attachToSession(sessionName);
+}
+//# sourceMappingURL=attach.js.map

package/dist/commands/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../src/commands/attach.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB;IACxD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;IACtD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,iBAAiB,WAAW,mBAAmB,CAAC,CAAC;IACnE,CAAC;IAED,eAAe,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC"}

package/dist/commands/config-validate.d.ts

@@ -0,0 +1,2 @@
+import type { Ui } from '../ui/output.js';
+export declare function runConfigValidateCommand(projectRoot: string, json: boolean, ui: Ui): Promise<void>;

package/dist/commands/config-validate.js

@@ -0,0 +1,10 @@
+import { loadRequiredConfig } from './helpers.js';
+export async function runConfigValidateCommand(projectRoot, json, ui) {
+    const config = await loadRequiredConfig(projectRoot);
+    if (json) {
+        ui.printJson({ ok: true, config });
+        return;
+    }
+    ui.success('Configuration is valid.');
+}
+//# sourceMappingURL=config-validate.js.map

package/dist/commands/config-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validate.js","sourceRoot":"","sources":["../../src/commands/config-validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAmB,EACnB,IAAa,EACb,EAAM;IAEN,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;AACxC,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,2 @@
+import type { Ui } from '../ui/output.js';
+export declare function runDoctorCommand(projectRoot: string, json: boolean, ui: Ui): Promise<void>;

package/dist/commands/doctor.js

@@ -0,0 +1,32 @@
+import { detectProjectFingerprint } from '../filesystem/project.js';
+import { probeAvailableRuntimes, getRuntimeAdapters } from '../providers/index.js';
+import { supportsBackgroundKeepAwake, supportsTmux } from '../runtime/tmux.js';
+export async function runDoctorCommand(projectRoot, json, ui) {
+    const [fingerprint, probes] = await Promise.all([
+        Promise.resolve(detectProjectFingerprint(projectRoot)),
+        probeAvailableRuntimes(projectRoot),
+    ]);
+    const runtimeChecks = await Promise.all(getRuntimeAdapters().map(async (adapter) => ({
+        provider: adapter.id,
+        checks: await adapter.doctor(projectRoot),
+    })));
+    const payload = {
+        fingerprint,
+        tmuxAvailable: supportsTmux(),
+        backgroundKeepAwakeAvailable: supportsBackgroundKeepAwake(),
+        runtimes: probes,
+        checks: runtimeChecks,
+    };
+    if (json) {
+        ui.printJson(payload);
+        return;
+    }
+    ui.info(`Package manager: ${fingerprint.packageManager}`);
+    ui.info(`Frameworks: ${fingerprint.frameworks.join(', ') || 'none detected'}`);
+    ui.info(`tmux available: ${supportsTmux() ? 'yes' : 'no'}`);
+    ui.info(`background keep-awake available: ${supportsBackgroundKeepAwake() ? 'yes' : 'no'}`);
+    for (const probe of probes) {
+        ui.info(`${probe.provider}: installed=${probe.installed} auth=${probe.auth.status} (${probe.auth.message})`);
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG/E,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,WAAmB,EAAE,IAAa,EAAE,EAAM;IAC/E,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC9C,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,WAAW,CAAC,CAAC;QACtD,sBAAsB,CAAC,WAAW,CAAC;KACpC,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,kBAAkB,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,QAAQ,EAAE,OAAO,CAAC,EAAE;QACpB,MAAM,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;KAC1C,CAAC,CAAC,CACJ,CAAC;IAEF,MAAM,OAAO,GAAG;QACd,WAAW;QACX,aAAa,EAAE,YAAY,EAAE;QAC7B,4BAA4B,EAAE,2BAA2B,EAAE;QAC3D,QAAQ,EAAE,MAAM;QAChB,MAAM,EAAE,aAAa;KACtB,CAAC;IAEF,IAAI,IAAI,EAAE,CAAC;QACT,EAAE,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO;IACT,CAAC;IAED,EAAE,CAAC,IAAI,CAAC,oBAAoB,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,IAAI,CAAC,eAAe,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,eAAe,EAAE,CAAC,CAAC;IAC/E,EAAE,CAAC,IAAI,CAAC,mBAAmB,YAAY,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,EAAE,CAAC,IAAI,CAAC,oCAAoC,2BAA2B,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAE5F,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,EAAE,CAAC,IAAI,CACL,GAAG,KAAK,CAAC,QAAQ,eAAe,KAAK,CAAC,SAAS,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,CACpG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/commands/helpers.d.ts

@@ -0,0 +1,4 @@
+import type { CorydoraConfig } from '../types/domain.js';
+export declare function resolveProjectRoot(startDir: string): string;
+export declare function configExists(projectRoot: string): boolean;
+export declare function loadRequiredConfig(projectRoot: string, configPath?: string): Promise<CorydoraConfig>;

package/dist/commands/helpers.js

@@ -0,0 +1,21 @@
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { CONFIG_FILE_NAME } from '../constants.js';
+import { loadConfig } from '../config/files.js';
+import { loadProjectEnv } from '../config/env.js';
+import { findGitRoot } from '../filesystem/project.js';
+export function resolveProjectRoot(startDir) {
+    return findGitRoot(startDir);
+}
+export function configExists(projectRoot) {
+    return existsSync(resolve(projectRoot, CONFIG_FILE_NAME));
+}
+export async function loadRequiredConfig(projectRoot, configPath) {
+    if (!configExists(projectRoot) && !configPath) {
+        throw new Error(`No ${CONFIG_FILE_NAME} file found in ${projectRoot}. Run "corydora init" first.`);
+    }
+    const config = await loadConfig(projectRoot, configPath);
+    await loadProjectEnv(projectRoot, config);
+    return config;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/commands/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/commands/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAGvD,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,WAAmB;IAC9C,OAAO,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,UAAmB;IAEnB,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,MAAM,gBAAgB,kBAAkB,WAAW,8BAA8B,CAClF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACzD,MAAM,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,7 @@
+import type { Ui } from '../ui/output.js';
+export interface InitCommandOptions {
+    projectRoot: string;
+    json: boolean;
+    yes?: boolean;
+}
+export declare function runInitCommand(options: InitCommandOptions, ui: Ui): Promise<void>;