@redspec/cli 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nate Hernandez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,8 @@
+# @redspec/cli
+
+```
+npx @redspec/cli init
+redspec status | check | new | accept | sync | doctor | board
+```
+
+See the root README for the commands, and `docs/agents/redspec.md` in an initialised repo for the conventions.

package/bin/redspec.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import("../dist/index.js").then((m) => m.run(process.argv))

package/dist/index.d.ts

@@ -0,0 +1,110 @@
+import { Command } from 'commander';
+import { Framework, Harness, SpecConfig, LoadedSpec, BundleReport, Finding } from '@redspec/core';
+import { Harness as Harness$1 } from '@redspec/method';
+
+type AcceptOptions = {
+    ids?: string[];
+    slice?: string;
+    clarification?: string;
+    /** Override the configured command. Tests use `true`/`false`. */
+    command?: string;
+    quiet?: boolean;
+};
+/**
+ * Re-stamp artifacts -- but only after the verification command passes in this
+ * same invocation. This is where all the discipline in the system can leak
+ * out, exactly as `--update-snapshots` does elsewhere, so there is no flag that
+ * skips the run.
+ */
+declare function accept(root: string, opts: AcceptOptions): Promise<number>;
+
+declare function check(root: string, opts?: {
+    json?: boolean;
+    quiet?: boolean;
+}): Promise<number>;
+
+declare function doctor(root: string): Promise<number>;
+
+type Written = {
+    path: string;
+    action: "created" | "updated" | "kept";
+};
+declare class Writer {
+    readonly root: string;
+    written: Written[];
+    constructor(root: string);
+    /** Write only if the file does not exist. */
+    create(rel: string, content: string): void;
+    /** Overwrite; these are generated files that carry a "generated" header. */
+    write(rel: string, content: string): void;
+    /** Replace or append a marked section, leaving the rest of the file alone. */
+    section(rel: string, content: string): void;
+    append(rel: string, content: string): void;
+    read(rel: string): string | null;
+}
+
+type InitOptions = {
+    root: string;
+    yes?: boolean;
+    harness?: string;
+    framework?: Framework;
+    quiet?: boolean;
+    /** Write the files but leave the dependencies to the caller. */
+    skipInstall?: boolean;
+};
+declare function init(opts: InitOptions): Promise<{
+    writer: Writer;
+    install: string[];
+    harnesses: Harness[];
+    framework: Framework;
+}>;
+
+declare function newFeature(root: string, slug: string, quiet?: boolean): Promise<number>;
+declare function newState(root: string, id: string, opts: {
+    surface?: string;
+    quiet?: boolean;
+}): Promise<number>;
+declare function newRule(root: string, id: string, opts: {
+    feature?: string;
+    form: string;
+    quiet?: boolean;
+}): Promise<number>;
+declare function newSlice(root: string, slug: string, name: string, opts: {
+    claims: string[];
+    amends: string[];
+    quiet?: boolean;
+}): Promise<number>;
+/** Regenerate the journey tier from the flows: one fixme per reachable path. */
+declare function newJourneys(root: string, slug: string, quiet?: boolean): Promise<number>;
+
+declare function status(root: string, opts?: {
+    ids?: string;
+}): Promise<number>;
+
+/** Render every configured harness's context and record what was written. */
+declare function sync(root: string, config: SpecConfig, harnesses?: Harness$1[]): Writer;
+
+type Context = {
+    root: string;
+    config: SpecConfig;
+    configPath: string | null;
+    specs: LoadedSpec[];
+    reports: BundleReport[];
+    /** Findings not tied to one bundle. */
+    extra: Finding[];
+    pkg: Record<string, unknown> | null;
+};
+declare function loadContext(root?: string, now?: Date): Promise<Context>;
+
+type Detection = {
+    harness: Harness;
+    evidence: string;
+};
+/** Which agent harnesses this repo already shows signs of. */
+declare function detectHarnesses(root: string, env?: NodeJS.ProcessEnv): Detection[];
+declare function detectFramework(pkg: Record<string, unknown> | null): Framework;
+
+declare function program(): Command;
+declare function run(argv: string[]): Promise<void>;
+
+export { accept, check, detectFramework, detectHarnesses, doctor, init, loadContext, newFeature, newJourneys, newRule, newSlice, newState, program, run, status, sync };