IF Commons GitHub

Repoctl

The operations program of this repository, repoctl: one command that makes every generated file in dependency order and reruns only the stale ones (sync, and sync --check for CI and hooks), merges a reference and makes a conflicting generated file again instead of resolving it by hand (merge), runs every check in one calm report with problem codes that repoctl explain explains (check), tells each library's version in the repository, on npm and in its tag (status), plans, makes and publishes a release behind the releaser tier and a typed confirmation (release plan|apply|publish), scaffolds a library of commons (new library), makes the commit with the repository's identity and trailers and refuses what must not be committed (commit), and says what is wrong with a checkout (doctor). It is a headless program in the layers of Kanon: its verbs are governance actions with reach policies and audience tiers (public, contributor, releaser), run through the command line, and served as tools by repoctl mcp, so that a person and an AI agent run the same deterministic repository operations. A library of commons with its own specifications.

FactValue
Version0.2.8
Conformance levelL1
Distributedgithub, npm
LicensePolyForm-Noncommercial-1.0.0, source-available: free for noncommercial use, commercial use needs a license from the owner (see Licensing in Start here)
Import it as@intellectual-frontiers/repoctl

Areas

Layers

LayerFolderMay import of this library
governancesrc/governance/nothing
logicalsrc/logical/governance
physicalsrc/physical/src/governance/, src/logical/

Imports

Core, Crypto, Headless, Lang Sql, Libraries, Net, System, Terminal

Specifications

Folders

FolderWhat it isMay import
spec-kit/The library's own specifications, numbered from 0001.nothing: Markdown and TSV
src/governance/Layer 1: what Repoctl is, as data and types that cannot be made wrong: the identities (a library, a version, an issue, a session, a subject), the audience tiers, the verbs with their facts and reach, the problem codes and their explanations, the table of generators with what each reads and writes, and the table of checks.core and the governance of headless, by package name
src/logical/Layer 2: what each verb reasons with, as pure functions and the ports of the world: the order of the generators, sync, merge, check, the version constants, the status, the publication, the scaffold of a library, the commit and the diagnosis.governance, by package name; core and the governance and logical layers of headless, by package name
src/physical/Layer 3: what touches the world: the adapters of the ports (programs, files, the registry of npm, the credential), the verbs on Headless with their options, operands and examples, the tree of the program and the tool server.governance and logical, by package name; core, headless, the parser of the terminal, the system and the libraries of commons, by package name
src/The entry of the program, repoctl.ts: the command line, the tier the host holds and the checkout it finds.the three layers
bin/The launcher the package's bin names: it registers the hook that lets Node 26 run TypeScript, then the program.src/
tools/The check bun run verify runs: the trace of sources and tests to the specifications.the kernel and the runtime, by package name
suite/The tests, which run the real programs and a real git, never stand-ins.src/; the runtime's test module, by package name

Quality

Quality: 113 tests: 113 passed, 0 failed, 0 skipped, 86 of 93 requirements proved, 0 open issues, 0 open tickets. The tests and issues of the library

Titles, headings, exports, tables, columns and requirements. Esc closes.