agent-readable-ts 0.1.4 → 0.1.6

package/README.md

@@ -1,305 +1,23 @@
 # agent-readable-ts
 
-Coding agents hallucinate a library's API — inventing methods, using stale signatures, or misusing real methods because the correct usage rules (lifecycle order, preconditions, anti-patterns) are not visible from the API surface alone.
+[![CI](https://github.com/zydo/agent-readable-ts/actions/workflows/ci.yml/badge.svg)](https://github.com/zydo/agent-readable-ts/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/agent-readable-ts.svg)](https://www.npmjs.com/package/agent-readable-ts)
 
-`agent-readable-ts` lets a library author attach those rules next to a class, object, or function. A package-level function `agentHelp(target)` returns curated, agent-oriented Markdown: the real public runtime surface that can be discovered safely, plus any author-supplied behavioral rules. An agent that calls `agentHelp(target)` before writing code against the target sees the real callable surface and the right usage rules.
+`agent-readable-ts` helps coding agents inspect the live public surface of a
+TypeScript or JavaScript API before they write code against it.
 
-> **For coding agents:** Install the agent skill to have this run automatically before coding against unfamiliar packages:
-> ```sh
-> npx skills add zydo/skills --skill agent-readable
-> ```
+Library authors can add agent-oriented usage rules next to a class, object, or
+function. Consumers call `agentHelp(target)` or the `agent-readable-ts` CLI to get
+compact Markdown with the real callable surface plus any author-supplied
+behavioral notes.
 
-**Token efficiency.** When an agent hallucinates an API, the resulting code fails — and each failed attempt triggers a retry cycle that burns tokens without making progress. `agent-readable-ts` generates compact, precise, accurate descriptions of publicly exposed interfaces (verified by runtime introspection on live packages). Calling `npx agent-readable-ts <package>` on unfamiliar packages and classes *before* writing code surfaces the real API upfront, preventing that waste.
-
-## Other languages
-
-- **Python:** [agent-readable](https://github.com/zydo/agent-readable) — same idea for Python packages and classes.
-
-## Install
+To let your coding agent automatically call `agentHelp()` before using an
+unfamiliar API, install the companion skill:
 
 ```sh
-npm install agent-readable-ts
-```
-
-## CLI
-
-The package includes a CLI for generating documentation from the command line. It works with local files **and installed npm packages**.
-
-```sh
-npx agent-readable-ts commander           # list all exports
-npx agent-readable-ts commander:Command   # document a specific export
-npx agent-readable-ts ./src/widget.ts:Widget   # a local TypeScript file
-```
-
-### Usage
-
-```sh
-agent-readable-ts [--install] <package-name>[:<export-name>]
-agent-readable-ts <module-path>[:<export-name>]
-```
-
-- **`package-name`** — any installed npm package (e.g. `commander`, `pino`, `@scope/package`)
-- **`module-path`** — a file path (`.js`, `.mjs`, or `.ts`) relative to the current directory
-- **`export-name`** — the named export to document (use dots for nested access, e.g. `Things.Helper`)
-- **`--install`** — allow fetching a package on demand when it is not installed locally (see [Security](#security))
-
-If no export name is given for a **package**, all exports are listed. If no export name is given for a **file**, the module namespace object is documented.
-
-> `.ts` files require `tsx` to be installed. It is included as a devDependency, and `npx` resolves it automatically.
-
-### Examples
-
-List all exports from an installed package:
-
-```sh
-npm install commander
-npx agent-readable-ts commander
-```
-
-Output:
-
-```markdown
-# commander
-
-## Exports
-
-- `CommanderError` class
-- `InvalidArgumentError` class
-- `Argument` class
-- `Option` class
-- `Help` class
-- `Command` class
-- `createCommand(name: string): Command` function
-- `createOption(flags: string, description: string): Option` function
-- `createArgument(name: string, description: string): Argument` function
-- `program` object
-```
-
-Document a specific export with full type signatures:
-
-```sh
-npx agent-readable-ts commander:Command
-```
-
-Output:
-
-```markdown
-# Command
-
-## Public API
-
-- `action(fn: (this: this, ...args: any[]) => void | Promise<void>): this` method
-- `addArgument(arg: Argument): this` method
-- `addCommand(cmd: Command, opts: CommandOptions): this` method
-- `addOption(option: Option): this` method
-- `alias(): string` method
-- `argument(name: string, description: string, defaultValue: unknown): this` method
-- `command(nameAndArgs: string, description: string, opts: ExecutableCommandOptions): this` method
-- `description(): string` method
-- `error(message: string, errorOptions: ErrorOptions): never` method
-- `hook(event: HookEvent, listener: (...args: any[]) => void | Promise<void>): this` method
-- `option(flags: string, description: string, defaultValue: unknown): this` method
-- `parse(argv: readonly string[], parseOptions: ParseOptions): this` method
-- `parseAsync(argv: readonly string[], parseOptions: ParseOptions): Promise<this>` method
-- `requiredOption(flags: string, description: string, defaultValue: unknown): this` method
-- `version(str: string, flags: string, description: string): this` method
-- ... (80+ methods total)
-
-## Agent usage rules
-
-- Prefer the public API listed above.
-- Do not use private, protected, underscored, or internal members.
-- Do not invent unsupported behavior.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-```
-
-Document a local file:
-
-```sh
-npx agent-readable-ts ./src/widget.ts:Widget    # a class export
-npx agent-readable-ts ./src/util.ts:connect     # a function export
-npx agent-readable-ts ./dist/api.js:fetch       # a .js file with adjacent api.d.ts
-```
-
-### Security
-
-To document a package, the CLI imports it, which executes the package's top-level code — only point it at packages you trust to run on your machine.
-
-When a package is not resolvable from the current project, the CLI can fetch it on demand with `npm install`. This never happens silently:
-
-- **Opt-in only.** On-demand fetching requires the `--install` flag. Without it, the CLI exits with an error telling you how to install the package yourself.
-- **Isolated cache.** Fetched packages go into `~/.cache/agent-readable-ts` (override with the `AGENT_READABLE_CACHE` environment variable), never into your project's `node_modules` or `package.json`.
-- **No lifecycle scripts.** The install runs with `--ignore-scripts`, so `preinstall`/`postinstall` scripts of fetched packages are never executed.
-- **No re-fetching.** Packages already present in the cache are loaded from disk without touching the network, and never require `--install` again.
-
-Packages already installed in your project are always loaded directly — no network access, no cache.
-
-## Two protocols
-
-| Protocol       | Role              | Output behavior                                  |
-| -------------- | ----------------- | ------------------------------------------------ |
-| `agentHelp()`  | Full replacement  | Returned Markdown is used verbatim               |
-| `agentNotes()` | Additive guidance | Notes are appended after auto-generated API docs |
-
-### `agentHelp()` — Full replacement
-
-If a target implements `agentHelp()`, the returned string **is** the output verbatim. No auto-generated sections are added.
-
-```ts
-import { AgentHelper, agentHelp } from "agent-readable-ts";
-
-class RateLimiter implements AgentHelper {
-  agentHelp(): string {
-    return `# RateLimiter
-
-## Usage
-
-- Create with \`new RateLimiter(maxRequests)\`.
-- Call \`acquire()\` before making a request.
-- Call \`release()\` after the request completes.
-
-## Limits
-
-- Default max is 100 concurrent requests.
-- Exceeding the limit blocks until a slot opens.
-`;
-  }
-}
-
-console.log(agentHelp(new RateLimiter()));
-```
-
-Output:
-
-```markdown
-# RateLimiter
-
-## Usage
-
-- Create with `new RateLimiter(maxRequests)`.
-- Call `acquire()` before making a request.
-- Call `release()` after the request completes.
-
-## Limits
-
-- Default max is 100 concurrent requests.
-- Exceeding the limit blocks until a slot opens.
-```
-
-If the target also defines `agentNotes()`, a warning is written to stderr and the notes are dropped.
-
-### `agentNotes()` — Additive guidance
-
-Define `agentNotes()` on any class to append usage rules to the auto-generated documentation. Notes accumulate across the inheritance chain in parent-to-child order.
-
-```ts
-import { AgentNoter, agentHelp } from "agent-readable-ts";
-
-class Sensor {
-  calibrate(offset: number): void {}
-  read(): number {
-    return 0;
-  }
-
-  agentNotes(): string {
-    return `
-## Do
-
-- Call \`calibrate()\` once during setup, before \`read()\`.
-
-## Do not
-
-- Do not call \`read()\` before \`calibrate()\` on first use.
-`;
-  }
-}
-
-console.log(agentHelp(new Sensor()));
-```
-
-### `agentHelp(target)` entry point
-
-The single entry point accepts:
-
-- Class constructors
-- Class instances
-- Plain objects
-- Plain functions
-- Arrow functions
-- Bound method values
-- Callable objects
-
-```ts
-import { agentHelp } from "agent-readable-ts";
-
-agentHelp(MyClass);          // class constructor
-agentHelp(new MyClass());    // class instance
-agentHelp({ a: 1 });        // plain object
-agentHelp(myFunction);       // function
-agentHelp(obj.method.bind(obj)); // bound method
-```
-
-## Examples
-
-### Example 1: Wrapping a class you do not own
-
-```ts
-import { agentHelp } from "agent-readable-ts";
-
-class Client {
-  connect(url: string): void {}
-  query(sql: string): unknown {
-    return undefined;
-  }
-}
-
-class DocumentedClient extends Client {
-  agentNotes(): string {
-    return `
-## Do
-
-- Call \`connect()\` before \`query()\`.
-
-## Do not
-
-- Do not pass untrusted SQL directly to \`query()\`.
-`;
-  }
-}
-
-console.log(agentHelp(new DocumentedClient()));
+npx skills add zydo/skills --skill agent-readable
 ```
 
-Output:
-
-```markdown
-# DocumentedClient
-
-## Public API
-
-- `connect(url)` method
-- `query(sql)` method
-
-## Agent usage rules
-
-- Prefer the public API listed above.
-- Do not use private, protected, underscored, or internal members.
-- Do not invent unsupported behavior.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-
-## Notes from DocumentedClient
-
-## Do
-
-- Call `connect()` before `query()`.
-
-## Do not
-
-- Do not pass untrusted SQL directly to `query()`.
-```
-
-### Example 2: Inheritance with accumulated notes
-
 ```ts
 import { agentHelp } from "agent-readable-ts";
 
@@ -310,255 +28,40 @@ class Sensor {
   }
 
   agentNotes(): string {
-    return `
-## Do
-
-- Call \`calibrate()\` once during setup, before \`read()\`.
-
-## Do not
-
-- Do not call \`read()\` before \`calibrate()\` on first use.
-`;
-  }
-}
-
-class CalibratedSensor extends Sensor {
-  reset(): void {}
-
-  override agentNotes(): string {
-    return `
-## Do
-
-- Use \`reset()\` only when recalibration is required.
-
-## Do not
-
-- Do not call \`reset()\` in the hot read path.
-`;
-  }
-}
-
-console.log(agentHelp(new CalibratedSensor()));
-```
-
-Output:
-
-```markdown
-# CalibratedSensor
-
-## Public API
-
-- `calibrate(offset)` method
-- `read()` method
-- `reset()` method
-
-## Agent usage rules
-
-- Prefer the public API listed above.
-- Do not use private, protected, underscored, or internal members.
-- Do not invent unsupported behavior.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-
-## Notes from Sensor
-
-## Do
-
-- Call `calibrate()` once during setup, before `read()`.
-
-## Do not
-
-- Do not call `read()` before `calibrate()` on first use.
-
-## Notes from CalibratedSensor (extends Sensor; if notes conflict, these take precedence)
-
-## Do
-
-- Use `reset()` only when recalibration is required.
-
-## Do not
-
-- Do not call `reset()` in the hot read path.
-```
-
-### Example 3: Full control via `agentHelp()`
-
-```ts
-import { agentHelp } from "agent-readable-ts";
-
-class RateLimiter {
-  agentHelp(): string {
-    return `# RateLimiter
-
-## Usage
-
-- Create with \`new RateLimiter(maxRequests)\`.
-- Call \`acquire()\` before making a request.
-- Call \`release()\` after the request completes.
-
-## Limits
-
-- Default max is 100 concurrent requests.
-- Exceeding the limit blocks until a slot opens.
-`;
-  }
-  agentNotes(): string {
-    return "This is ignored because agentHelp() owns the full output.";
-  }
-}
-
-console.log(agentHelp(new RateLimiter()));
-```
-
-Output:
-
-```markdown
-# RateLimiter
-
-## Usage
-
-- Create with `new RateLimiter(maxRequests)`.
-- Call `acquire()` before making a request.
-- Call `release()` after the request completes.
-
-## Limits
-
-- Default max is 100 concurrent requests.
-- Exceeding the limit blocks until a slot opens.
-```
-
-A warning is written to stderr noting that `agentNotes()` is ignored.
-
-### Example 4: Any class, no setup
-
-```ts
-import { agentHelp } from "agent-readable-ts";
-
-class Cache {
-  get(key: string): unknown {
-    return undefined;
+    return "- Call `calibrate()` once during setup, before `read()`.";
   }
-  set(key: string, value: unknown): void {}
-  clear(): void {}
 }
 
-console.log(agentHelp(new Cache()));
-```
-
-Output:
-
-```markdown
-# Cache
-
-## Public API
-
-- `clear()` method
-- `get(key)` method
-- `set(key, value)` method
-
-## Agent usage rules
-
-- Prefer the public API listed above.
-- Do not use private, protected, underscored, or internal members.
-- Do not invent unsupported behavior.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-```
-
-### Example 5: Functions and bound methods
-
-```ts
-import { agentHelp } from "agent-readable-ts";
-
-function connect(host: string, port: number): void {}
-
-class Runner {
-  execute(command: string): number {
-    return 0;
-  }
-}
-
-const runner = new Runner();
-
-console.log(agentHelp(connect));
-console.log(agentHelp(runner.execute.bind(runner)));
+console.log(agentHelp(new Sensor()));
 ```
 
-Output for `connect`:
-
-````markdown
-# connect
-
-## Signature
+## Install
 
-```ts
-connect(host, port)
+```sh
+npm install agent-readable-ts
 ```
 
-## Agent usage rules
-
-- Call this function according to the signature above.
-- Do not invent unsupported parameters, return values, side effects, or lifecycle behavior.
-- Do not use private, underscored, or internal implementation details.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-````
+For one-off CLI use, two parallel series:
 
-Output for the bound method:
-
-````markdown
-# execute
-
-## Signature
-
-```ts
-execute(arg0)
+```sh
+npx agent-readable-ts commander        # npm series
+pnpm dlx agent-readable-ts commander   # pnpm series
 ```
 
-## Agent usage rules
-
-- Call this function according to the signature above.
-- Do not invent unsupported parameters, return values, side effects, or lifecycle behavior.
-- Do not use private, underscored, or internal implementation details.
-- If usage is ambiguous, prefer the simplest documented usage pattern.
-````
-
-## Warning output
+See [Getting Started](docs/getting-started.md) for both series, repeated-use installs, and full CLI usage.
 
-By default, advisory warnings are written to `process.stderr`. You can redirect or silence them:
-
-```ts
-import { setWarnOutput, getWarnOutput } from "agent-readable-ts";
-
-// Redirect to a custom sink
-setWarnOutput((chunk: string) => {
-  console.log("[WARN]", chunk.trim());
-});
-
-// Or use an object with a write method
-setWarnOutput({ write(chunk: string) { /* handle */ } });
-
-// Silence warnings
-setWarnOutput(null);
-
-// Restore default
-setWarnOutput(process.stderr);
-```
+## Documentation
 
-## Limitations in TypeScript
+- [Getting Started](docs/getting-started.md)
+- [Why agent-readable-ts?](docs/why.md)
+- [Examples](docs/examples.md)
+- [Authoring Notes](docs/authoring.md)
+- [FAQ](docs/faq.md)
 
-Runtime JavaScript reflection cannot read TypeScript type annotations, interfaces, overloads, generic parameters, return types, or doc comments. The auto-generated documentation is intentionally conservative:
+## Other Languages
 
-- **Parameter names** are recovered from `Function.prototype.toString()` when possible. For native or bound functions, names fall back to `arg0`, `arg1`, etc. using `Function.length`. Destructured parameters also fall back to `argN`.
-- **Type information** is available in two ways:
-  - **CLI with `.ts` source**: full types are extracted by parsing the source file with the TypeScript compiler API.
-  - **CLI with `.js`/`.mjs`/`.cjs` files**: types are extracted from adjacent `.d.ts`/`.d.mts`/`.d.cts` declaration files if present (covers published packages).
-  - **Library API (`agentHelp()`)**: no type information — only runtime parameter names and arity.
-- **No per-method descriptions.** Authors convey prose through `agentNotes()` or by implementing `agentHelp()`.
-- **Constructors are not invoked** during introspection. Construction guidance belongs in notes.
-- **Instance fields** can only be discovered from an actual instance or plain object, not from a class constructor.
-- **Getters are not invoked** during introspection.
-- **TypeScript `private` and `protected`** are compile-time constructs. The library excludes names starting with `_` but cannot perfectly detect visibility at runtime.
-- **JavaScript `#private` fields and methods** are not reflectable and never appear in output.
-- **Module-level documentation** is not supported.
-- **Dynamic package import or CLI-based introspection** is intentionally omitted.
+- **Python:** [agent-readable](https://github.com/zydo/agent-readable) provides
+  the same idea for Python packages and classes.
 
 ## License
 

package/dist/src/cli.js

@@ -1,13 +1,14 @@
 #!/usr/bin/env node
 import { agentHelp } from "./index.js";
-import { resolvePackageTypesPath, listPackageExports } from "./source-types.js";
-import { parseSpecifier, isBarePackageName, splitPackageSpec, walkExportPath, loadTypeSigs, formatExportList, listRuntimeExports, loadPackage, } from "./packages.js";
+import { resolvePackageTypesPath, listPackageExports, resolveBuiltinTypesPath } from "./source-types.js";
+import { CliUsageError, parseCliArgs, parseSpecifier, isBarePackageName, splitPackageSpec, walkExportPath, loadTypeSigs, formatExportList, listRuntimeExports, loadPackage, } from "./packages.js";
 import { pathToFileURL } from "node:url";
 import { resolve } from "node:path";
 import { readFileSync } from "node:fs";
 function usage() {
     process.stderr.write("Usage: agent-readable-ts [--install] <module-path>[:<export-name>]\n" +
         "       agent-readable-ts [--install] <package-name>[:<export-name>]\n" +
+        "       agent-readable-ts node:<builtin>[:<export-name>]\n" +
         "\n" +
         "Options:\n" +
         "  --install  Allow fetching a package on demand (with npm install) when it\n" +
@@ -41,6 +42,25 @@ async function handleFile(modulePath, exportName) {
     const typeSigs = loadTypeSigs(absolutePath, leafName(exportName));
     process.stdout.write(agentHelp(target, typeSigs));
 }
+// ── node: builtin handling ─────────────────────────────────────────────────────
+async function handleBuiltin(modulePath, exportName) {
+    let mod;
+    try {
+        mod = (await import(modulePath));
+    }
+    catch (err) {
+        fail(`Cannot import "${modulePath}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+    // No export name: list all exports
+    if (!exportName) {
+        process.stdout.write(formatExportList(modulePath, listRuntimeExports(mod)));
+        return;
+    }
+    const target = walkExportPath(mod, exportName);
+    const dtsPath = resolveBuiltinTypesPath(modulePath);
+    const typeSigs = dtsPath ? loadTypeSigs(dtsPath, leafName(exportName)) : undefined;
+    process.stdout.write(agentHelp(target, typeSigs));
+}
 // ── package-based handling ─────────────────────────────────────────────────────
 async function handlePackage(spec, exportName, allowInstall) {
     const { name } = splitPackageSpec(spec);
@@ -62,20 +82,13 @@ async function handlePackage(spec, exportName, allowInstall) {
     process.stdout.write(agentHelp(target, typeSigs));
 }
 // ── main ───────────────────────────────────────────────────────────────────────
-const args = process.argv.slice(2);
-const allowInstall = args.includes("--install");
-const positional = args.filter((arg) => arg !== "--install");
-const unknownFlag = positional.find((arg) => arg.startsWith("--"));
-if (unknownFlag) {
-    process.stderr.write(`Error: Unknown option "${unknownFlag}"\n`);
-    usage();
-}
-const specifier = positional[0];
-if (!specifier)
-    usage();
 try {
+    const { allowInstall, specifier } = parseCliArgs(process.argv.slice(2));
     const { modulePath, exportName } = parseSpecifier(specifier);
-    if (isBarePackageName(modulePath)) {
+    if (modulePath.startsWith("node:")) {
+        await handleBuiltin(modulePath, exportName);
+    }
+    else if (isBarePackageName(modulePath)) {
         await handlePackage(modulePath, exportName, allowInstall);
     }
     else {
@@ -83,6 +96,10 @@ try {
     }
 }
 catch (err) {
+    if (err instanceof CliUsageError) {
+        process.stderr.write(`Error: ${err.message}\n`);
+        usage();
+    }
     fail(err instanceof Error ? err.message : String(err));
 }
 //# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"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"}