@guiho/runx 0.2.6 → 0.4.0

package/docs/superpowers/superpowers.xdocs.md

@@ -0,0 +1,21 @@
+---
+subject: runx-superpowers
+description: Approved design specifications produced before RunX implementation planning and code changes.
+parent: runx-docs
+children:
+  - runx-superpowers-specs
+files: {}
+documents: {}
+tags:
+  - documentation
+  - design
+keywords:
+  - runx
+  - superpowers
+  - specifications
+flags: []
+status: stable
+---
+
+This module groups approved RunX design specifications that define behavior,
+interfaces, ownership, validation, and release gates before implementation.

package/docs/todo/rfc-0034-cli-compliance-migration-implementation.md

@@ -0,0 +1,58 @@
+---
+name: RunX RFC 0034 CLI Compliance Migration Implementation
+purpose: Preserve the executed RX-01 through RX-16 implementation record.
+description: Records the delivered module changes, breaking-contract decisions, test-hang diagnosis, and validation handoff for the RunX RFC migration.
+created: 2026-07-18
+flags:
+  - completed
+tags:
+  - implementation
+  - cli
+keywords:
+  - RFC 0034
+  - RX-01
+  - RX-16
+  - RunX
+owner: runx-todo
+---
+
+# RunX RFC 0034 CLI Compliance Migration Implementation
+
+## Summary
+
+RX-01 through RX-16 were implemented as one breaking pre-1.0 migration. RunX
+now has one Citty tree, Bun-only core modules, TypeBox-decoded configuration,
+cache and release boundaries, complete Developer Context help, the singular
+agent namespace, transactional upgrades, complete installers, a Node-compatible
+npm bootstrap, and the exact fourteen release assets.
+
+## Implementation Map
+
+- RX-02-RX-05: `path-utils.ts`, `storage.ts`, `configuration.ts`,
+  `update-cache.ts`, release schemas, and shared types establish Bun-first I/O
+  and TypeBox boundaries.
+- RX-06-RX-08: `cli.ts` and `help.ts` own the exact Citty tree, exit mapping,
+  startup lifecycle, Unicode tree help, depth validation, and Markdown help.
+- RX-09: `agents.ts`, embedded resources, the bundled skill, and
+  `prompts/guiho-i-runx.md` implement dual-tool skills, instruction blocks, and
+  prompt discovery.
+- RX-10-RX-11: CLI output, release pagination, upgrade selection, replacement,
+  rollback, reconciliation, and cache behavior use stable contracts.
+- RX-12-RX-14: both installers, `scripts/runx-bin.mjs`, the binary builder,
+  asset verifier, and GitHub workflows enforce the installation and fourteen
+  asset contracts.
+- RX-15-RX-16: canonical docs, TODO, xdocs, review, validation, tests, builds,
+  and release preparation were aligned to the executable.
+
+## Test-Hang Diagnosis
+
+The original unbounded suite hung in legacy process-oriented tests. The
+individual CLI baseline passed 10/10, proving the CLI was not persistently
+stuck. The obsolete tests were replaced or bounded; the final complete suite
+runs 38 tests and exits normally in about 28 seconds.
+
+## References
+
+- [Plan](../plans/rfc-0034-cli-compliance-migration.md)
+- [Implementation review](../reviews/implementation/rfc-0034-cli-compliance-migration-review.md)
+- [Validation](../validation/rfc-0034-cli-compliance-migration.md)

package/docs/todo/rfc-0034-cli-compliance-migration.md

@@ -0,0 +1,151 @@
+---
+name: Migrate RunX To Full RFC 0034 Compliance
+purpose: Define the required outcome, scope, constraints, and completion signals for the RunX RFC 0034 migration task.
+description: Captures what must be true after RunX adopts the complete GUIHO CLI contract and links the executable migration plan.
+created: 2026-07-18
+flags:
+  - approved
+  - breaking-change
+  - completed
+tags:
+  - todo
+  - cli
+  - migration
+keywords:
+  - runx
+  - RFC 0034
+  - guiho-s-0034-cli-engineer
+  - agent namespace
+  - fourteen release assets
+owner: runx-todo
+---
+
+# Migrate RunX To Full RFC 0034 Compliance
+
+## Summary
+
+Bring RunX into complete compliance with GUIHO RFC 0034. This is an approved
+breaking migration for a pre-1.0 CLI. Compatibility with `runx r`, root selector
+shorthand, `--file`, upward manifest discovery, `runx agents`, `--tool`, old
+markers, `macos` asset names, and the Bun-dependent npm launcher is not required.
+
+## Todo Index
+
+- Task: `1. Migrate RunX To Full RFC 0034 Compliance`
+- Status: completed
+- Index: [TODO.md](../../TODO.md)
+
+## Outcome
+
+RunX uses the mandatory Bun/TypeScript/Citty/TypeBox stack, has a Bun-only core,
+implements the exact startup/configuration/help/agent/upgrade/installer/output
+contracts, ships a Node-compatible npm bootstrap, and publishes exactly twelve
+RFC-named binaries plus `guiho-s-runx` and `guiho-i-runx`.
+
+## Scope
+
+### In scope
+
+- Core CLI source, entrypoints, command tree, domain adapters, and errors.
+- `runx.yaml` resolution and TypeBox decoding.
+- update cache and background worker under `~/.guiho/runx/`.
+- all Developer Context help modes at every scope.
+- complete singular `agent skill`, `agent instruction`, and `agent prompt`
+  namespaces.
+- transactional upgrade, catalog pagination, and post-upgrade reconciliation.
+- PowerShell and POSIX installers.
+- Node-compatible npm bootstrap.
+- exact fourteen-asset build and release enforcement.
+- tests, CI, README, DOCS, bundled skill, TODO, changelog, decisions, and xdocs.
+
+### Out of scope
+
+- Workflow dependency graphs or a proprietary task language.
+- Remote command execution.
+- Secret management.
+- Publishing, version bumping, tagging, or live installation without separate
+  authorization.
+
+## Acceptance Signals
+
+- No prohibited Node built-ins exist in core CLI source.
+- No arguments prints exactly `Hello Windows - runx v<version>`.
+- `runx.yaml` resolves only by `--config`, effective cwd, then the standardized
+  global path, and prints its absolute loaded path.
+- TypeBox decodes configuration, cache, remote releases, structured flags, and
+  stable output objects before use.
+- Only `-h` and root `-v` short aliases exist.
+- Every command scope supports standard help, tree help, positive tree depth,
+  and redirect-safe Markdown help.
+- The final command catalog in the plan is the only public catalog.
+- Agent skill actions target both agent-tool directories; instruction actions
+  handle zero, one, or both instruction files idempotently; prompt output obeys
+  raw/names-only rules.
+- Upgrade, list pagination, pre-release filtering, installers, and the npm
+  wrapper pass isolated tests.
+- Release verification finds exactly fourteen correctly named assets and no
+  `macos` names.
+- Typecheck, tests, safe builds, xdocs validation, implementation review, and
+  validation reporting complete successfully.
+
+## Dependencies And Context
+
+- [Executable migration plan](../plans/rfc-0034-cli-compliance-migration.md)
+- `guiho-a-0001-swe` is the coordinating Software Engineer/SWE agent.
+- `guiho-s-0034-cli-engineer` is the mandatory specialist skill.
+- The current Citty migration, upgrade work, and bundled RunX skill are inputs,
+  not constraints that override RFC 0034.
+
+## Watch-outs
+
+- Inspection and dry-run commands must never spawn a manifest command.
+- JSON stdout must remain one parseable document.
+- The foreground startup path must never await a network request.
+- Tests must isolate home directories, skill installation, instruction files,
+  update caches, executable replacement, and release hosting.
+- Generated `library/`, `bin/`, `bundle/`, and `vendor/` outputs remain
+  unedited.
+- Breaking changes are approved, but unrelated RunX domain behavior must not be
+  removed accidentally.
+
+## Before Starting
+
+- Read the repository and parent instructions, this spec, and the full plan.
+- Load the SWE agent and every skill named in the plan.
+- Confirm the live branch, clean/understood worktree, and baseline checks.
+- Inventory current agent behavior and prohibited imports again because source
+  may have changed after this plan was written.
+
+## While Working
+
+- Execute one numbered plan unit at a time with `guiho-s-0023-plan-executor`.
+- Update implementation notes, TODO state, docs, tests, and xdocs in the same
+  unit.
+- Do not preserve an obsolete interface merely to avoid a breaking change.
+- Stop on unapproved publishing, tagging, pushing, or real global installation.
+
+## After Finishing
+
+- Run implementation review and validation reporting.
+- Record every passed, failed, and skipped check.
+- Keep the TODO in `testing` until all local acceptance signals are proven.
+- Request separate authorization before Mirror versioning or release actions.
+
+## Related Files
+
+- [Implementation plan](../plans/rfc-0034-cli-compliance-migration.md) -
+  Ordered file-level execution units and validation gates.
+- [CLI architecture](../architecture/cli-architecture.md) - Current architecture
+  that the migration must revise where it conflicts with RFC 0034.
+- [Previous Citty decision](../decisions/citty-cli-migration.md) - Earlier
+  compatibility contract that must be superseded where it conflicts.
+- [Plan review](../reviews/plans/rfc-0034-cli-compliance-migration-review.md) -
+  Ready-for-execution review of sequencing, coverage, and approval gates.
+
+## References
+
+- [TODO.md](../../TODO.md)
+- [AGENTS.md](../../AGENTS.md)
+- [Implementation notes](./rfc-0034-cli-compliance-migration-implementation.md)
+- [Implementation review](../reviews/implementation/rfc-0034-cli-compliance-migration-review.md)
+- [Validation report](../validation/rfc-0034-cli-compliance-migration.md)

package/docs/todo/todo.xdocs.md

@@ -4,15 +4,19 @@ description: Linked task specifications for the RunX TODO index.
 parent: runx-docs
 children: []
 files:
-  implement-runx-alpha.md: Defines the completion signals and constraints for the alpha task.
   protect-branches-and-tag-creation.md: Records the verified active GitHub branch and release-tag rulesets for RunX.
+  rfc-0034-cli-compliance-migration.md: Defines the required breaking migration outcome, scope, constraints, and completion signals for full RFC 0034 compliance.
+  rfc-0034-cli-compliance-migration-implementation.md: Records the delivered RX units, implementation map, and test-hang diagnosis.
 documents:
-  implement-runx-alpha.md: Task specification for implementing RunX alpha.
   protect-branches-and-tag-creation.md: Completed task specification with active RunX ruleset IDs, protected patterns, and verification evidence.
+  rfc-0034-cli-compliance-migration.md: Task specification linked from TODO task 1 for the full RunX CLI contract migration.
+  rfc-0034-cli-compliance-migration-implementation.md: Completed implementation and validation handoff for TODO task 1.
 tags:
   - todo
 keywords:
   - runx
+  - RFC 0034
+  - CLI migration
   - tasks
 flags: []
 status: stable

package/docs/validation/interactive-init-manifest.md

@@ -0,0 +1,79 @@
+---
+name: RunX Interactive Init Manifest Validation
+purpose: Record executable verification evidence for the RunX initializer and strict manifest contract.
+description: Captures typecheck, tests, library and native builds, compiled CLI smoke checks, and XDocs validation for runx init.
+created: 2026-07-14
+flags:
+  - passed
+tags:
+  - validation
+  - cli
+  - manifest
+keywords:
+  - runx init
+  - runx.yaml
+  - bun test
+  - native binary
+  - xdocs
+owner: runx-validation
+---
+
+# RunX Interactive Init Manifest Validation
+
+## Summary
+
+The interactive initializer and strict manifest contract passed all applicable
+local validation gates. No release, version, tag, package publication, cloud,
+or secret operation was performed.
+
+## Scope
+
+- Citty registration and help surfaces for `runx init`.
+- SemVer `1.x`, scripts-directory, `public` group, and empty-command manifest
+  validation.
+- Prompt cancellation, overwrite confirmation, exact generated YAML, atomic
+  write validation, and non-interactive error behavior.
+- User documentation and XDocs metadata.
+
+## Commands Run
+
+| Command | Result | Evidence |
+| --- | --- | --- |
+| `bun run typecheck` | Passed | Strict TypeScript compilation completed without diagnostics. |
+| `bun test` | Passed | 22 tests and 180 assertions passed across CLI, manifest, initializer, and self-management suites. |
+| `bun run build` | Passed | Library output compiled successfully. |
+| `bun run binary` | Passed | Native Windows executable compiled to `bin/runx.exe`. |
+| `bin/runx.exe --help-tree` | Passed | The compiled command tree includes `init`. |
+| `xdocs meta source --strict --format json` | Passed | The new initializer and test files are fully described. |
+| `xdocs meta docs\\plans --documents --strict --format json` | Passed | The plan and companion metadata validate. |
+| `xdocs meta docs\\reviews\\plans --documents --strict --format json` | Passed | The plan review and companion metadata validate. |
+| `xdocs tree` | Passed | The RunX documentation hierarchy is intact. |
+| `git diff --check` | Passed | No whitespace errors were reported before delivery records were added. |
+
+## Manual Checks
+
+- The generated empty manifest has the required version, project, scripts,
+  `public` group, and `commands: []` shape.
+- No empty `scripts/` directory is created by initialization.
+- `runx init --file ...` and `runx init --format json` return explicit errors
+  without creating a manifest.
+
+## Skipped Checks
+
+A person-driven interactive terminal session could not be run in this automated
+non-TTY environment. The initializer’s prompt sequence is covered through its
+injected prompt adapter; the compiled executable was smoke-tested for command
+registration.
+
+## Readiness
+
+Ready for code review and a draft pull request. The bundled agent-skill
+automation remains intentionally outside this change and is tracked by issue
+#11.
+
+## References
+
+- [Decision](../decisions/interactive-init-manifest.md)
+- [Plan](../plans/interactive-init-manifest.md)
+- [Implementation Review](../reviews/implementation/interactive-init-manifest-review.md)
+- GitHub issue [#10](https://github.com/CGuiho/runx/issues/10)

package/docs/validation/rfc-0034-cli-compliance-migration.md

@@ -0,0 +1,67 @@
+---
+name: RunX RFC 0034 CLI Compliance Migration Validation
+purpose: Record direct verification evidence for every migration completion gate.
+description: Command results for typecheck, tests, builds, CLI contracts, npm bootstrap, installers, release assets, imports, xdocs, and Git integrity.
+created: 2026-07-18
+flags:
+  - validated
+tags:
+  - validation
+  - cli
+keywords:
+  - RFC 0034
+  - 38 tests
+  - 14 assets
+  - RunX
+owner: runx-validation
+---
+
+# RunX RFC 0034 CLI Compliance Migration Validation
+
+## Summary
+
+All local RFC completion gates passed. No validation blocker remains.
+
+## Commands Run
+
+| Command or check | Result |
+| --- | --- |
+| `bun run typecheck` | Passed |
+| `bun test --timeout 30000` | Passed: 38 tests, 262 assertions |
+| `bun run build` | Passed |
+| `bun run binary` | Passed |
+| `bun run binaries` | Passed: twelve native targets |
+| `bun run verify-assets` | Passed: exactly fourteen unique assets |
+| `node --check scripts/runx-bin.mjs` | Passed |
+| packed npm bootstrap local-server smoke | Passed with Node and Bun removed from PATH |
+| prohibited core Node-import scan | Passed: zero matches |
+| CLI banner/help/config/agent/output/exit smoke tests | Passed in CLI suite |
+| PowerShell and POSIX installer contract tests | Passed |
+| `xdocs doctor --warnings-as-errors` | Passed: zero errors and zero warnings |
+| `git diff --check` | Passed |
+
+## Exact Release Asset Evidence
+
+The verifier observed twelve `runx-*` assets using Linux, Darwin, and Windows
+names plus `guiho-s-runx` and `guiho-i-runx`. It found no duplicate, extra,
+missing, or legacy platform name.
+
+## Skipped Checks
+
+- No npm publication.
+- No GitHub Release creation.
+- No live global RunX replacement or global agent installation.
+- No production deployment.
+
+These are release mutations rather than local validation requirements.
+
+## Readiness
+
+Ready for the authorized Mirror minor version application, one-file commits,
+main push, and Mirror-managed tag/ref push. Package publication and GitHub
+Release creation remain intentionally unperformed.
+
+## References
+
+- [Implementation review](../reviews/implementation/rfc-0034-cli-compliance-migration-review.md)
+- [Implementation notes](../todo/rfc-0034-cli-compliance-migration-implementation.md)

package/docs/validation/upgrade-reliability.md

@@ -0,0 +1,124 @@
+---
+name: RunX Upgrade Reliability Validation
+purpose: Record release-ready verification evidence for GitHub issues 12 and 13.
+description: Results for release pagination, progress reporting, transactional replacement, rollback, recovery commands, direct installers, native builds, live release smokes, and XDocs integrity.
+created: 2026-07-15
+flags:
+  - superseded
+  - needs-revalidation
+tags:
+  - validation
+  - cli
+  - reliability
+keywords:
+  - runx upgrade
+  - upgrade list
+  - windows replacement
+  - recovery install
+  - issue 12
+  - issue 13
+owner: runx-validation
+---
+
+# RunX Upgrade Reliability Validation
+
+## Current Status
+
+The first validation pass below is superseded by independent review findings.
+The implementation has since been corrected for exact JSON envelope fidelity,
+post-backup rename/rollback state, downgrade prevention, installer failure
+classification, Ubuntu portability, and executable controlled installer tests.
+Candidate verification now has a bounded ten-second timeout in the CLI and both
+direct installers. Those corrections still require the complete release gate
+to be rerun before this document or the TODO task can return to
+`validated`/`completed`.
+
+No package publication, version apply, or tag operation was performed.
+
+## Superseded Automated Gate
+
+| Command | Result |
+| --- | --- |
+| `bun run typecheck` | Passed. |
+| `bun test` | Passed: 37 tests, 0 failures, 245 assertions across 8 files. |
+| `bun run build` | Passed; TypeScript library output compiled. |
+| `bun run binary` | Passed; local native executable compiled. |
+| `bun run binaries` | Passed; all 12 Linux, macOS, and Windows release assets compiled and were non-empty. |
+| `bun test devops/installers.spec.ts` | Superseded: the earlier suite relied partly on source-pattern checks. The replacement suite executes controlled native installer and recovery scenarios and awaits revalidation. |
+
+Generated `library/` and `bin/` outputs remain ignored and are not part of the
+committed change.
+
+## Superseded Behavior Evidence
+
+- Release-catalog tests follow `Link: rel="next"`, reject malformed/non-2xx
+  responses, apply SemVer prerelease precedence, retain invalid tags last, and
+  enforce baseline/default/modern asset candidates.
+- Reporting tests prove the complete plan precedes `Downloading`, which
+  precedes the download body and then `Validating`, `Replacing`, and
+  `Verifying`.
+- The Windows test runs a copied executable, keeps it mapped in a live process,
+  renames it, installs the new canonical executable immediately, verifies the
+  exact version, and allows only old-image cleanup to be deferred.
+- Failure tests reject non-native downloads before mutation and restore the
+  original executable after target verification failure.
+- Bun-launcher failure returns a recovery command pinned to the resolved target
+  instead of losing recovery at the generic CLI error boundary.
+- Installer tests enforce unique temporary paths, exact target versions,
+  canonical verification, rollback language/behavior, and separate stop
+  commands.
+
+## Superseded Compiled Binary Smoke
+
+The compiled `runx-windows-x64-baseline.exe` reported version `0.2.7`.
+`upgrade --dry-run` queried live GitHub release metadata and printed the full
+plan before any mutation, followed by the pinned `0.2.7` PowerShell recovery
+command and the separate safe stop command. `upgrade list --format json`
+returned one valid schema-versioned document containing all eight currently
+published releases from `0.2.7` through `0.2.0`, newest first, with current,
+latest-stable, publication, channel, and compatible-asset data.
+
+The first smoke command targeted `bin/runx.exe` after the complete matrix build
+had replaced the local single-binary output with named assets. It failed only
+because that path no longer existed; the smoke was immediately rerun against
+the actual baseline matrix asset and passed.
+
+## Superseded XDocs Gate
+
+Using an equivalent validation-only XDocs configuration with agent file writes
+disabled:
+
+- strict metadata passed for `docs/plans`, `docs/reviews/plans`, `docs/todo`,
+  `source`, `devops`, and `skills/guiho-s-runx`;
+- `xdocs doctor --warnings-as-errors --format json` returned `valid: true`,
+  zero errors, and zero warnings; and
+- `xdocs tree` returned one connected RunX tree without duplicate subjects or
+  orphans.
+
+## Release Boundary
+
+The branch preserves package version `0.2.7`. A future merge/release owner must
+use Mirror to plan and apply any requested patch release; this implementation
+does not publish or tag automatically.
+
+## Required Revalidation
+
+- `bun run typecheck`
+- `bun test`, including the controlled installer/recovery suite on Ubuntu and Windows
+- `bun run build`, `bun run binary`, and `bun run binaries`
+- compiled CLI text/JSON smokes, including failed and rolled-back envelopes
+- strict XDocs metadata, doctor warnings-as-errors, and tree validation
+
+The current isolated Windows worktree could not begin that rerun because
+`bun install --frozen-lockfile` was denied while opening `bun.lock` with
+`EPERM`. This is an environment validation blocker, not a passing result.
+
+## Review-Correction Checks
+
+| Command | Result |
+| --- | --- |
+| Cached TypeScript 6 compiler, `-p . --noEmit` | Passed after the review corrections. |
+| PowerShell parser for `devops/install.ps1` | Passed. |
+| Git Bash `bash -n devops/install.sh` | Passed. |
+| `git diff --check` | Passed. |
+| Focused Bun tests | Blocked before test execution by `EPERM` reading the isolated worktree and `tsconfig.json`; zero tests passed in that attempt. |

package/docs/validation/validation.xdocs.md

@@ -6,20 +6,29 @@ children: []
 files:
   alpha-implementation-summary.md: Records the completed alpha implementation, checks, and release boundaries.
   citty-cli-migration.md: Records the complete local validation gate for the Citty command-tree migration.
+  interactive-init-manifest.md: Records validation evidence for the interactive initializer and strict manifest contract.
   windows-self-upgrade.md: Records Windows replacement, rollback, cleanup, native build, CI, and XDocs validation evidence.
+  upgrade-reliability.md: Tracks the superseded first pass and required revalidation after independent upgrade reliability review corrections.
+  rfc-0034-cli-compliance-migration.md: Records passing RFC tests, builds, bootstrap, installer, import, and fourteen-asset evidence.
 documents:
   alpha-implementation-summary.md: Validation summary for the first RunX implementation.
   citty-cli-migration.md: Validation evidence for TypeScript, tests, native assets, npm packaging, CLI behavior, and XDocs.
+  interactive-init-manifest.md: Validation evidence for the RunX interactive init manifest feature.
   npm-trusted-publishing-0.2.2.md: Validation evidence for the blocked 0.2.2 npm trusted-publishing retry.
   windows-self-upgrade.md: Validation evidence for GitHub issues #9 and #1 and the Windows self-upgrade patch.
+  upgrade-reliability.md: Revalidation record for GitHub issues 12 and 13; currently marked needs-revalidation.
+  rfc-0034-cli-compliance-migration.md: Complete RFC 0034 validation and readiness report.
 tags:
   - validation
 keywords:
   - runx
   - citty
+  - runx init
+  - scripts directory
   - tests
   - summary
   - windows self-upgrade
+  - upgrade reliability
 flags: []
 status: stable
 ---

package/library/agents.d.ts

@@ -1,11 +1,35 @@
-import type { AgentScope, AgentTool } from './types.js';
+/**
+ * @copyright Copyright © 2026 GUIHO Technologies as represented by Cristóvão GUIHO. All Rights Reserved.
+ */
+import type { AgentScope } from './types.js';
+export { applyAgentInstructions, installAgentSkill, listAgentPrompts, listAgentSkills, removeAgentInstructions, showAgentInstructions, showAgentPrompt, showAgentSkill, uninstallAgentSkill, updateAgentInstructions, updateAgentSkill, };
 type EmbeddedResources = {
     skill: string;
+    prompt: string;
 } | undefined;
 declare global {
     var __RUNX_EMBEDDED_RESOURCES__: EmbeddedResources;
 }
-export declare const installAgentSkill: (scope: AgentScope, tool: AgentTool, cwd: string) => Promise<string[]>;
-export declare const installAgentInstructions: (cwd: string) => Promise<string>;
-export {};
+declare function installAgentSkill(scope: AgentScope, cwd: string): Promise<string[]>;
+declare function updateAgentSkill(scope: AgentScope, cwd: string): Promise<string[]>;
+declare function uninstallAgentSkill(scope: AgentScope, cwd: string): Promise<string[]>;
+declare function listAgentSkills(filter?: string): Array<{
+    id: string;
+    description: string;
+}>;
+declare function showAgentSkill(id: string): Promise<{
+    id: string;
+    path: string;
+    description: string;
+    metadata: Record<string, string>;
+}>;
+declare function applyAgentInstructions(cwd: string): Promise<string[]>;
+declare function updateAgentInstructions(cwd: string): Promise<string[]>;
+declare function removeAgentInstructions(cwd: string): Promise<string[]>;
+declare function showAgentInstructions(): Promise<string>;
+declare function listAgentPrompts(namesOnly?: boolean): string[] | Array<{
+    id: string;
+    description: string;
+}>;
+declare function showAgentPrompt(id: string): Promise<string>;
 //# sourceMappingURL=agents.d.ts.map

package/library/agents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAGvD,KAAK,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAEtD,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,2BAA2B,EAAE,iBAAiB,CAAA;CACnD;AAKD,eAAO,MAAM,iBAAiB,UAAiB,UAAU,QAAQ,SAAS,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,EAAE,CAiBzG,CAAA;AAED,eAAO,MAAM,wBAAwB,QAAe,MAAM,KAAG,OAAO,CAAC,MAAM,CAgB1E,CAAA"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../source/agents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,GACjB,CAAA;AAED,KAAK,iBAAiB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAAA;AAEtE,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,2BAA2B,EAAE,iBAAiB,CAAA;CACnD;AAOD,iBAAe,iBAAiB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAElF;AAED,iBAAe,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEjF;AAED,iBAAe,mBAAmB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAIpF;AAED,iBAAS,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAIpF;AAED,iBAAe,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAQtI;AAED,iBAAe,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEpE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAErE;AAED,iBAAe,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrE;AAED,iBAAe,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC,CAEtD;AAED,iBAAS,gBAAgB,CAAC,SAAS,UAAQ,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAIlG;AAED,iBAAe,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG1D"}