git:20261014.9788453 to git:20261016.003143b

+ **ASE** ships three deliverables from one repository:

+ - `plugin/skills/ase-xxx-xxx/`: the 57 skills, each with a `SKILL.md`

+ (agent instructions) and a `help.md` (Unix-style manual page), plus

+ optional skill-specific files (like `ase-help-intent/data.md`, the

+ concatenation of all `help.md` files, generated at build-time);

+ the `help.md` files document only the user-facing skill surface

+ (purpose, options, arguments, and usage examples), *not* the

+ internals of the skills (the workflow steps of `SKILL.md`, the

+ leveraged sub-agents, meta files, and MCP tools, and their

+ interplay), so consult the `SKILL.md` and its referenced files for

+ the latter and never add implementation details to the `help.md`

+ files

+ - `plugin/meta/`: the shared meta files, exposed to skills via

+ `ase util meta <name>`: the constitution, tenets, persona, dialog,

+ control flow, getopt, and skill output conventions

+ (`ase-{constitution,tenets,persona,dialog,control,getopt,skill}.md`),

+ the common steps shared by groups of skills (`ase-common-*.md`),

+ and the artifact formats (`ase-format-{meta,task,spec}.md`), where

+ the specification format `ase-format-spec.md` includes the SpecBook

+ models and formats description `ase-format-specbook.md` and the

+ standard SpecBook schema configuration `ase-format-specbook.yaml`,

+ both generated at build-time by *SpecBook* (`@rse/specbook`)

+ - `plugin/output-styles/`: the output style `ase-terse`

+ - `plugin/mods/`: the Claude Code function hooks module ("mod")

+ `ase-mods.ts`, re-rendering the grilling tables of ASE,

+ type-checked against the downloaded `claude-code.d.ts`

+ - `tool/src/ase-<command>.ts`: one module per CLI command resp.

+ command group: `setup`, `config`, `service`, `mcp`, `hook`,

+ `statusline`, `task`, `task-board`, `agent`, `artifact`, `spec`,

+ `man`, `util`, and `util-{meta,diagram,worktree,mint,metric,compat}`

+ - `tool/src/ase-lib-*.ts`: the generic library modules (`lib-log`,

+ `lib-stdio`, `lib-table`, `lib-ignore`, `lib-version`,

+ `lib-daemon-cli` for the start/status/log/stop CLI commands of all

+ background processes (servers, agents, and the agent fleet), and

+ `lib-server-cli` and `lib-server-bind` for the CLI commands and the

+ HTTP binding of the task store and agent relay servers)

+ - `tool/src/ase-setup-*.ts`: the parts of `ase setup`

+ (`setup-common` for the shared types and sub-process runner,

+ `setup-mcp` for the MCP server registry, and `setup-settings` for

+ the statusline and output style settings)

+ - `tool/src/ase-config-*.ts`: the parts of `ase config`

+ (`config-scope` for the scope chain and directory resolution,

+ `config-schema` for the schema, presets, and write policies, and

+ `config-core` for the layered `Config` class and the internal

+ session state)

+ - `tool/src/ase-service-*.ts`: the MCP-only tool modules of the

+ service (`service-{kv,getopt,markdown,skills,sleep,state,timestamp}`)

+ and its AI usage accounting (`service-otel` for the OTLP ingress,

+ the usage windows of the task assignments, and their bookings onto

+ the usage attachments of the tasks)

+ - `tool/src/ase-task-*.ts`: the task functionality, where `ase-task.ts`

+ itself only forwards the `ase task` CLI and `ase_task_*` MCP tools to

+ the task store selected by `project.task.store.url`, through the

+ local or remote task store clients of `task-store-client`

+ (see `docs/task-api.md`):

+ - `task-format` for the textual task format codec and the

+ lifecycle models, and `task-request` for the codec of the agent

+ requests attached to tasks, like the edit requests of the task

+ boards

+ - the task store: `task-store-server-cli` for the `ase task store`

+ CLI wrapper, `task-store-core` for the transport-agnostic REST

+ API functionality, `task-store-server-bind` for its HTTP and

+ WebSocket binding, `task-store-plugin-api` for the storage

+ plugin contract, `task-store-plugin-delegate` for the plugin

+ loader and the locking storage delegate, the built-in storage

+ plugins `task-store-plugin-{ase,github,gitlab,gitea}` (file-based

+ resp. GitHub, GitLab, and Gitea Issues), and `task-store-issues`

+ for the common parts of all issue tracker storage plugins

+ - the task board: `task-board` for the `ase task board` CLI

+ command, `task-board-{core,graph,filter,stats}` for its model,

+ `task-board-tui` (split into `task-board-tui-{model,control,view,popup,style}`)

+ for the terminal UI, and `task-board-web-server` for the browser

+ UI, served by the service, with its client in

+ `ase-task-board-web-client.{html,ts,vue,styl}`, a Vue

+ application bundled by Vite, whose root component is split

+ into the modules `task-board-web-client-{model,editor,control}`

+ (shared state and service access, task plan editor, and

+ actions and key dispatching) and the components

+ `task-board-web-client-{lanes,graph,agents,stats,dialog,popup,title}`

+ - `tool/src/ase-agent-*.ts`: the parts of `ase agent`:

+ - `agent-runtime` for the runtime base of all agents,

+ `agent-runtime-tool` for the headless agent tool invocation

+ and the decoding of its output, `agent-runtime-exec` for the

+ processes, temporary directories, jobs, and Git operations,

+ `agent-runtime-claim` for the run locks and task claims of the

+ crash recovery, `agent-runtime-{phase,request}` for the runtime bases of the

+ phase resp. request agents, and `agent-runtime-engine` for the

+ engine running every agent of a definition (its phase and

+ request agents) and its facades: the built-in agents, the agents

+ of the definition kinds, and the `adhoc` agent

+ - `agent-definition-api` for the public, self-contained types of

+ the agent definitions and their hooks (exported as the types of

+ the `@rse/ase` package), `agent-definition-core` for the

+ definition model (options, YAML, TypeScript, JavaScript, and

+ built-in definition loading, discovery of the definition kinds,

+ hooks, validation, and templates), and

+ `agent-definition-builtin/{planner,implementer,approver,integrator,editor}`

+ for the declarative definitions of the modes of the built-in

+ agents

+ - `agent-process` for the `ase agent <kind> start|status|log|stop`

+ commands of a single agent, and `agent-fleet` for the

+ `ase agent fleet` supervisor of multiple agents and the agent

+ relay

+ - the agent relay, selected by `project.relay.url` and passing the

+ live presence of the agents to the task boards:

+ `agent-relay-server-cli` for the `ase agent relay` CLI wrapper,

+ `agent-relay-core` for the transport-agnostic in-memory

+ presence, `agent-relay-server-bind` for its HTTP and WebSocket

+ binding (mountable into the task store server), and

+ `agent-relay-client` for the relay URL resolution, the client,

+ and the presence reporter of the agents

+ - `tool/man/ase{,-xxx{,-yyy}}.md`: the Unix manual pages of all CLI

+ commands (one per command and command group, where the pages of a

+ group with third-level commands like `ase task store` cover them),

+ in the *remark-man* Markdown format, rendered at build-time into

+ `dst/man/*.1` (installed by npm via `directories.man`); they

+ document only the user-facing CLI surface (commands, options,

+ arguments, configuration, and files), *not* the internals of

+ `tool/src/` (modules, classes, functions, types, and their

+ interplay), so consult the source code for the latter and never

+ add implementation details to the manual pages

+ - `pages/src/pages/`: the pages of the site (`index.astro`, `author`,

+ `design`, `highlights`, `project`, `setup`, `usage`, `workflows`,

+ `typing-demo`, and `usecases/[usecase]`), all based on

+ `pages/src/layouts/BaseLayout.astro`

+ - `pages/src/components/*.astro`: the page sections (`Section-*`),

+ modals (`Modal-*`), widgets (`Widget-*`), and client-side features

+ (`Feature-*`)

+ single source of truth for skill grouping and ordering), and

+ `comparison.ts`, `fit.ts`, `methods.ts`, `nav.ts`, `previews.ts`,

+ `site.ts`, `testimonials.ts`, and `usecases.ts`

+ Additionally, the repository root carries `docs/` (hand-written

+ documentation and diagram sources), `etc/` (the top-level `stx.conf` and the

+ version bumping script `version.mts`), `.claude-plugin/marketplace.json`

+ and `.github/plugin/marketplace.json` (the plugin marketplace manifests),

+ `.github/workflows/static.yml` (the GitHub Pages deployment of `pages/`),

+ and `bin/ase` (a development shim which builds `tool/` on demand and runs

+ it with `ASE_SETUP_DEV=1`).

+ npm start publish # lint, bump version, build, commit, tag, push, npm publish, GitHub release

+ npm start lint # markdownlint-cli2 + eslint over meta/, skills/, and output-styles/,

+ # tsc over mods/, and "claude plugin validate"

+ # and meta/ase-format-specbook.{md,yaml}

+ npm start lint # eslint over src/ + vue-tsc type-check of the web board client

+ npm start build # lint + build-cmd + build-man + build-plugin

+ npm start build-cmd # tsc of the program and its public types + vite build

+ # of the web board client (emits into dst/)

+ npm start build-man # remark-man rendering of man/*.md into dst/man/*.1

+ npm start build-container # build and push the multi-arch container image (etc/ase.dockerfile)

+ ase setup status # report plugin, MCP server, output style, statusline, and telemetry registrations

+ `--tool claude|copilot|codex` (default: `claude`, or `$ASE_TOOL`; the

+ statusline is unsupported for `codex`) and, for `claude` only,

+ `--scope user|project|local` (default: `user`, except for `update`,

+ `uninstall`, `enable`, and `disable`, which auto-detect the scope of the

+ existing plugin installation). The exceptions are `ase setup status`,

+ which reports *all* scopes at once, and `ase setup telemetry

+ activate|deactivate`, which always writes user-level configuration, and

+ hence both take no `--scope`. Additionally, `install`, `update`, and

+ `uninstall` accept `--dev` (default: `$ASE_SETUP_DEV`) to use the local

+ working copy instead of the remote or bundled repository.

+ Beyond `ase setup`, the CLI provides:

+

+ - `ase config`: the layered `user` < `project` < `task` < `session` configuration

+ - `ase service`: the per-project background HTTP service

+ - `ase mcp`: the stdio-to-service MCP bridge

+ - `ase hook`: the agent tool hook handlers

+ - `ase statusline`: the statusline renderer

+ - `ase task`: the persisted task plans, including `ase task board` for

+ the interactive task board in terminal and browser, and `ase task

+ store` for the task store server

+ - `ase agent`: the autonomous agents, each running in its own process,

+ managed individually via `ase agent <kind> start|status|log|stop`

+ (e.g. `ase agent implementer start -p 2`):

+ - the task lifecycle agents `planner`, `implementer`, `approver`, and

+ `integrator`, which together drive the `enterprise` task lifecycle

+ model headless

+ - the `editor` agent, which processes the prompt-driven edit requests

+ of the task boards in any lifecycle model

+ - the agents of the definition kinds, whose entire behavior is

+ configured by a definition file `<kind>.{yaml,yml,ts,mts,js,mjs,cjs}`

+ of the project (`.ase/agents/`) or of the user (`agents/` of the

+ user configuration directory), where a definition kind replaces a

+ built-in kind of the same name, resp. by the options of the `adhoc`

+ agent (with example definitions in `tool/man/ase-agent-adhoc.md`); the

+ built-in agents are themselves declarative definitions run by the

+ same agent engine

+ - `ase agent relay`: the per-user agent relay server, passing the

+ live presence of the agents to the task boards

+ - `ase agent fleet start|status|log|stop`: a fleet of agents (and of

+ the relay) of a YAML configuration (initially created via `ase

+ agent fleet init`), run through a supervising process, restarting

+ every exited member with an exponential backoff

+ - `ase artifact`: the artifact kind resolution

+ - `ase spec`: the SpecBook specification linting, exporting, and previewing

+ - `ase man`: the manual pages of `tool/man/` shipped with the tool, shown via `man`(1)

+ - `ase util`: the utility commands `ase util meta` (plugin meta file

+ output), `ase util diagram` (Mermaid rendering), `ase util worktree`

+ (ASE worktree path resolution), `ase util mint` (hash-derived

+ identifier minting), `ase util metric` (text length metrics), and

+ `ase util compat` (probe values for the `ase-meta-compat` self-test

+ skill)

+

+ See the manual pages `tool/man/*.md` (e.g. `ase man ase`) for the full details.