@chief-clancy/core

Board integrations, schemas, types, and shared utilities for Clancy.

This package is part of the Clancy monorepo. You don't install it directly — it's a dependency of @chief-clancy/dev and @chief-clancy/terminal.

[!WARNING] Clancy is in early development. Expect breaking changes and rough edges.

[!WARNING] Not supported for standalone use. This package is consumed transitively by other @chief-clancy/* packages. Inside this monorepo those links use workspace dependencies; published packages depend on @chief-clancy/core via normal version ranges. Its public API may change without notice.

Deep-import surface (as of 1.0.0): consumers may import from the package root (@chief-clancy/core) or the four namespaced subpaths: @chief-clancy/core/types/*.js, @chief-clancy/core/schemas/*.js, @chief-clancy/core/shared/*.js, @chief-clancy/core/board/*.js. The * matches nested paths — e.g. @chief-clancy/core/board/github/api.js resolves. Top-level deep imports (@chief-clancy/core/foo.js) are no longer resolvable — the 0.1.x ./*.js wildcard export has been replaced by the four subdirectory wildcards above. Barrier-Core (1.0.0) deleted all internal index.ts barrels under these subtrees, so consumers now import leaf modules directly from those exported paths.

What's in it

Board integrations

Unified Board type abstraction with implementations for 6 platforms:

• Jira — REST API v3, JQL queries, ADF description parsing
• GitHub Issues — REST API, PR filtering, label management
• Linear — GraphQL API, workflow state resolution
• Shortcut — REST API v3, workflow state filtering
• Notion — REST API, database rows as tickets, property overrides
• Azure DevOps — REST API, WIQL queries, work item management

All boards implement the same interface: ping, validateInputs, fetchTicket, fetchTickets, fetchBlockerStatus, fetchChildrenStatus, transitionTicket, ensureLabel, addLabel, removeLabel, sharedEnv.

Schemas

zod/mini schemas for validating API responses from all 6 board providers and environment configuration from .clancy/.env.

Shared utilities

Cache (Cached<T>), HTTP (fetchAndParse, retryFetch), git operations, remote detection, label helpers, and environment parsing.

Documentation

• Architecture — full module map and dependency graph
• Technical Reference — board integration details and gotchas
• Testing — test patterns and coverage

Part of the Clancy monorepo

• chief-clancy — full pipeline (install, configure, implement, autopilot)
• @chief-clancy/terminal — installer, slash commands, hooks, runners
• @chief-clancy/dev — standalone ticket executor
• @chief-clancy/scan — codebase scanning agents and workflows
• @chief-clancy/brief — strategic brief generator
• @chief-clancy/plan — implementation planner

Credits

Built on the Ralph technique by Geoffrey Huntley. See CREDITS.md.

License

MIT — see LICENSE.