persona-harness 0.3.0-alpha.0

package/dist/cli/bearshell.js

@@ -0,0 +1,189 @@
+import { spawnSync } from "node:child_process";
+import process from "node:process";
+const DEFAULT_BUDGET = 20_000;
+const MIN_BUDGET = 80;
+export function bearshellUsage(invocation = "ph") {
+    return [
+        `Usage: ${invocation} bearshell <command> [args...]`,
+        `   or: ${invocation} bearshell [--json] [--budget <chars>] <command> [args...]`,
+        `   or: ${invocation} bearshell --shell '<shell command>'`,
+        "",
+        "Runs a bounded shell-native command helper for Persona Harness.",
+        "Shell metacharacters are interpreted only with explicit --shell opt-in.",
+        "",
+        "Environment:",
+        "- PH_BEARSHELL_CONDENSE=0 disables output condensation.",
+        "- PH_BEARSHELL_CONDENSE_BUDGET overrides the default condensation budget.",
+        "- PH_BEARSHELL_SPARK=0 is accepted for OMO compatibility; this MVP uses deterministic condensation only.",
+    ].join("\n");
+}
+export function runBearshell(args, options = {}) {
+    const env = options.env ?? {};
+    const parsed = parseBearshellArgs(args, env);
+    if (parsed.kind === "help") {
+        return formatResult({ status: 0, stdout: `${bearshellUsage()}\n`, stderr: "" }, parsed.json);
+    }
+    if (parsed.kind === "invalid") {
+        return formatResult({ status: 1, stdout: "", stderr: `${parsed.message}\n\n${bearshellUsage()}\n` }, parsed.json);
+    }
+    const childEnv = { ...process.env, ...env };
+    const spawned = parsed.shell
+        ? spawnSync(parsed.command, {
+            cwd: options.cwd,
+            encoding: "utf8",
+            env: childEnv,
+            shell: true,
+        })
+        : spawnSync(parsed.command, [...parsed.args], {
+            cwd: options.cwd,
+            encoding: "utf8",
+            env: childEnv,
+            shell: false,
+        });
+    const status = spawned.status ?? signalExitCode(spawned.signal);
+    const stdout = maybeCondense(toOutputString(spawned.stdout), parsed.budget, env);
+    const stderr = maybeCondense(spawnErrorMessage(parsed.command, spawned.error) ?? toOutputString(spawned.stderr), parsed.budget, env);
+    return formatResult({ status, stdout, stderr }, parsed.json);
+}
+function parseBearshellArgs(args, env) {
+    let json = false;
+    let shell = false;
+    let budget = readBudget(env["PH_BEARSHELL_CONDENSE_BUDGET"]) ?? DEFAULT_BUDGET;
+    const positional = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === undefined) {
+            continue;
+        }
+        if (arg === "--help" || arg === "-h") {
+            return { kind: "help", json };
+        }
+        if (arg === "--json") {
+            json = true;
+            continue;
+        }
+        if (arg === "--shell") {
+            shell = true;
+            const command = args[index + 1];
+            if (command === undefined || command.length === 0) {
+                return { kind: "invalid", json, message: "--shell requires a command string" };
+            }
+            return { kind: "exec", json, shell: true, budget, command, args: [] };
+        }
+        if (arg === "--budget") {
+            const value = args[index + 1];
+            if (value === undefined) {
+                return { kind: "invalid", json, message: "--budget requires a positive integer" };
+            }
+            const parsedBudget = readBudget(value);
+            if (parsedBudget === null) {
+                return { kind: "invalid", json, message: "--budget requires a positive integer" };
+            }
+            budget = parsedBudget;
+            index += 1;
+            continue;
+        }
+        positional.push(arg);
+    }
+    if (positional.length === 0) {
+        return { kind: "help", json };
+    }
+    const command = positional[0];
+    if (command === undefined) {
+        return { kind: "help", json };
+    }
+    return { kind: "exec", json, shell: false, budget, command, args: positional.slice(1) };
+}
+function readBudget(value) {
+    if (value === undefined || value.trim().length === 0) {
+        return DEFAULT_BUDGET;
+    }
+    const parsed = Number(value);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        return null;
+    }
+    return Math.max(parsed, MIN_BUDGET);
+}
+function maybeCondense(output, budget, env) {
+    if (env["PH_BEARSHELL_CONDENSE"] === "0") {
+        return output;
+    }
+    if (output.length <= budget) {
+        return output;
+    }
+    const markerBudget = 96;
+    const contentBudget = Math.max(MIN_BUDGET, budget - markerBudget);
+    const headLength = Math.floor(contentBudget * 0.6);
+    const tailLength = contentBudget - headLength;
+    const head = output.slice(0, headLength).trimEnd();
+    const tail = output.slice(output.length - tailLength).trimStart();
+    const omitted = output.length - head.length - tail.length;
+    return [
+        head,
+        `[bearshell condensed] original chars: ${output.length}; budget: ${budget}; omitted: ${omitted}`,
+        tail,
+    ].join("\n");
+}
+function formatResult(result, json) {
+    if (!json) {
+        return result;
+    }
+    return {
+        status: result.status,
+        stdout: `${JSON.stringify(result)}\n`,
+        stderr: "",
+    };
+}
+function toOutputString(value) {
+    return typeof value === "string" ? value : "";
+}
+function spawnErrorMessage(command, error) {
+    if (error === undefined) {
+        return undefined;
+    }
+    return `[bearshell] failed to launch ${command}: ${error.message}\n`;
+}
+function signalExitCode(signal) {
+    if (signal === null) {
+        return 1;
+    }
+    const signalCodeByName = {
+        SIGABRT: 6,
+        SIGALRM: 14,
+        SIGBREAK: 21,
+        SIGBUS: 7,
+        SIGCHLD: 17,
+        SIGCONT: 18,
+        SIGFPE: 8,
+        SIGHUP: 1,
+        SIGILL: 4,
+        SIGINT: 2,
+        SIGIO: 29,
+        SIGIOT: 6,
+        SIGKILL: 9,
+        SIGPIPE: 13,
+        SIGPOLL: 29,
+        SIGPROF: 27,
+        SIGPWR: 30,
+        SIGQUIT: 3,
+        SIGSEGV: 11,
+        SIGSTKFLT: 16,
+        SIGSTOP: 19,
+        SIGSYS: 31,
+        SIGTERM: 15,
+        SIGTRAP: 5,
+        SIGTSTP: 20,
+        SIGTTIN: 21,
+        SIGTTOU: 22,
+        SIGUNUSED: 31,
+        SIGURG: 23,
+        SIGUSR1: 10,
+        SIGUSR2: 12,
+        SIGVTALRM: 26,
+        SIGWINCH: 28,
+        SIGXCPU: 24,
+        SIGXFSZ: 25,
+    };
+    return 128 + (signalCodeByName[signal] ?? 1);
+}
+//# sourceMappingURL=bearshell.js.map

package/dist/cli/bearshell.js.map

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

package/dist/cli/history.d.ts

@@ -0,0 +1,15 @@
+import type { CliRunResult } from "./bearshell.js";
+type HistoryOptions = {
+    readonly projectDir?: string;
+    readonly now?: Date;
+};
+type HistoryArchiveResult = {
+    readonly archiveDir: string;
+    readonly archiveId: string;
+    readonly archivedFiles: readonly string[];
+    readonly missingFiles: readonly string[];
+};
+export declare function historyUsage(invocation?: string): string;
+export declare function archiveWorkflowHistory(options?: HistoryOptions, archiveIdInput?: string): HistoryArchiveResult;
+export declare function runHistoryCommand(args: readonly string[], options?: HistoryOptions, invocationName?: string): CliRunResult;
+export {};

package/dist/cli/history.js

@@ -0,0 +1,156 @@
+import { copyFileSync, existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { join, resolve } from "node:path";
+import process from "node:process";
+class WorkflowHistoryError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "WorkflowHistoryError";
+    }
+}
+const WORKFLOW_DIR = ".persona/workflow";
+const HISTORY_DIR = ".persona/workflow/history";
+const WORKFLOW_ARTIFACTS = [
+    { filename: "plan.md" },
+    { filename: "implementation-report.md" },
+    { filename: "review-report.md" },
+];
+export function historyUsage(invocation = "ph") {
+    return [
+        `Usage: ${invocation} history [--id <archive-id>]`,
+        "",
+        "Archives completed workflow artifacts after a run has been used.",
+        "",
+        "Input:",
+        `- ${WORKFLOW_DIR}/plan.md`,
+        `- ${WORKFLOW_DIR}/implementation-report.md`,
+        `- ${WORKFLOW_DIR}/review-report.md`,
+        "",
+        "Output:",
+        `- ${HISTORY_DIR}/<archive-id>/`,
+        "",
+        "Scope:",
+        "- local workflow history only",
+        "- does not delete active workflow files",
+        "- not product-quality certification",
+    ].join("\n");
+}
+function parseHistoryArgs(args) {
+    let archiveId;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === "--help" || arg === "-h") {
+            return { kind: "help" };
+        }
+        if (arg === "--id") {
+            const value = args[index + 1];
+            if (value === undefined) {
+                return { kind: "invalid", message: "--id requires a value" };
+            }
+            archiveId = value;
+            index += 1;
+            continue;
+        }
+        return { kind: "invalid", message: `Unknown option: ${arg}` };
+    }
+    return { kind: "run", archiveId };
+}
+function assertValidArchiveId(archiveId) {
+    if (!/^[A-Za-z0-9._-]+$/.test(archiveId)) {
+        throw new WorkflowHistoryError("Archive id may contain only letters, numbers, dots, underscores, and hyphens.");
+    }
+}
+function defaultArchiveId(now) {
+    return now.toISOString().replace(/[:.]/g, "-");
+}
+function artifactPath(projectDir, filename) {
+    return join(projectDir, WORKFLOW_DIR, filename);
+}
+function createSummary(result) {
+    return [
+        "# Persona Workflow History",
+        "",
+        `Archive ID: \`${result.archiveId}\``,
+        `Archive path: \`${result.archiveDir}\``,
+        "",
+        "## Archived Files",
+        "",
+        ...listLines(result.archivedFiles),
+        "",
+        "## Missing Files",
+        "",
+        ...listLines(result.missingFiles),
+        "",
+        "## Limitations",
+        "",
+        "- This is local workflow history evidence.",
+        "- It does not certify generated app product quality.",
+        "- It does not enforce rule compliance.",
+        "",
+    ].join("\n");
+}
+function listLines(values) {
+    if (values.length === 0) {
+        return ["- none"];
+    }
+    return values.map((value) => `- ${value}`);
+}
+export function archiveWorkflowHistory(options = {}, archiveIdInput) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const archiveId = archiveIdInput ?? defaultArchiveId(options.now ?? new Date());
+    assertValidArchiveId(archiveId);
+    const archiveDir = join(projectDir, HISTORY_DIR, archiveId);
+    if (existsSync(archiveDir)) {
+        throw new WorkflowHistoryError(`${HISTORY_DIR}/${archiveId} already exists.`);
+    }
+    const archivedFiles = [];
+    const missingFiles = [];
+    for (const artifact of WORKFLOW_ARTIFACTS) {
+        const sourcePath = artifactPath(projectDir, artifact.filename);
+        if (existsSync(sourcePath)) {
+            archivedFiles.push(artifact.filename);
+        }
+        else {
+            missingFiles.push(artifact.filename);
+        }
+    }
+    if (archivedFiles.length === 0) {
+        throw new WorkflowHistoryError(`No workflow artifacts found under ${WORKFLOW_DIR}. Run ph plan first.`);
+    }
+    mkdirSync(archiveDir, { recursive: true });
+    for (const filename of archivedFiles) {
+        copyFileSync(artifactPath(projectDir, filename), join(archiveDir, filename));
+    }
+    const result = { archiveDir, archiveId, archivedFiles, missingFiles };
+    writeFileSync(join(archiveDir, "summary.md"), createSummary(result));
+    return result;
+}
+export function runHistoryCommand(args, options = {}, invocationName = "ph") {
+    const parsed = parseHistoryArgs(args);
+    if (parsed.kind === "help") {
+        return { status: 0, stdout: `${historyUsage(invocationName)}\n`, stderr: "" };
+    }
+    if (parsed.kind === "invalid") {
+        return { status: 1, stdout: "", stderr: `${parsed.message}\n\n${historyUsage(invocationName)}\n` };
+    }
+    try {
+        const result = archiveWorkflowHistory(options, parsed.archiveId);
+        return {
+            status: 0,
+            stdout: [
+                "Persona Harness workflow history archived.",
+                "",
+                `Archive: ${result.archiveDir}`,
+                `Archived files: ${result.archivedFiles.length}`,
+                `Missing files: ${result.missingFiles.length}`,
+            ].join("\n") + "\n",
+            stderr: "",
+        };
+    }
+    catch (error) {
+        if (error instanceof WorkflowHistoryError) {
+            return { status: 1, stdout: "", stderr: `${error.message}\n` };
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/cli/history.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { type CliRunResult } from "./bearshell.js";
+type PersonaCliOptions = {
+    readonly cwd?: string;
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    readonly invocationName?: string;
+    readonly packageRoot?: string;
+};
+export declare function runPersonaCli(args: readonly string[], options?: PersonaCliOptions): CliRunResult;
+export {};

package/dist/cli/index.js

@@ -0,0 +1,117 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+import { runInitCommand } from "./init.js";
+import { runBearshell } from "./bearshell.js";
+import { runHistoryCommand } from "./history.js";
+import { runIntakeCommand, runInteractiveIntakeCommand } from "./intake.js";
+import { runPlanCommand } from "./plan-command.js";
+import { runPolicyCommand } from "./policy.js";
+export function runPersonaCli(args, options = {}) {
+    const command = args[0];
+    const invocationName = options.invocationName ?? "ph";
+    if (command === "init") {
+        return runInitCommand({ projectDir: options.cwd, packageRoot: options.packageRoot });
+    }
+    if (command === "intake") {
+        return runIntakeCommand(args.slice(1), { projectDir: options.cwd }, invocationName);
+    }
+    if (command === "plan") {
+        return runPlanCommand(args.slice(1), { projectDir: options.cwd }, invocationName);
+    }
+    if (command === "policy") {
+        return runPolicyCommand(args.slice(1), { projectDir: options.cwd }, invocationName);
+    }
+    if (command === "history") {
+        return runHistoryCommand(args.slice(1), { projectDir: options.cwd }, invocationName);
+    }
+    if (command === "bearshell") {
+        return runBearshell(args.slice(1), { cwd: options.cwd, env: options.env });
+    }
+    if (command === undefined || command === "--help" || command === "-h") {
+        return { status: 0, stdout: `${personaCliUsage(invocationName)}\n`, stderr: "" };
+    }
+    return {
+        status: 1,
+        stdout: "",
+        stderr: `Unknown command: ${command}\n\n${personaCliUsage(invocationName)}\n`,
+    };
+}
+function personaCliUsage(invocationName) {
+    return [
+        `Usage: ${invocationName} <command> [args...]`,
+        "",
+        "Commands:",
+        "  init                         Install Persona Harness config into the current project.",
+        "  intake                       Create a draft backend project profile for planning.",
+        "  plan                         Create a blackbear architecture plan draft before implementation.",
+        "  policy                       Create backend-only policy overlay files.",
+        "  history                      Archive completed workflow artifacts into local history.",
+        "  bearshell <command> [args...] Run a bounded command helper for repo inspection and smoke tests.",
+        "",
+        "Examples:",
+        `  ${invocationName} init`,
+        `  ${invocationName} intake`,
+        `  ${invocationName} plan`,
+        `  ${invocationName} policy init`,
+        `  ${invocationName} history --id run-001`,
+        `  ${invocationName} bearshell npm test`,
+        `  ${invocationName} bearshell --shell 'git status --short && npm test'`,
+    ].join("\n");
+}
+function writeResult(result) {
+    if (result.stdout.length > 0) {
+        process.stdout.write(result.stdout);
+    }
+    if (result.stderr.length > 0) {
+        process.stderr.write(result.stderr);
+    }
+    process.exitCode = result.status;
+}
+async function runCliEntrypoint() {
+    const args = process.argv.slice(2);
+    const invocationName = process.argv[1]?.endsWith("/persona-harness") ? "persona-harness" : "ph";
+    if (args[0] === "intake" && args.includes("--interactive")) {
+        const readline = createInterface({ input: process.stdin, output: process.stdout });
+        try {
+            const result = await runInteractiveIntakeCommand(args.slice(1), {
+                projectDir: process.cwd(),
+                isTty: process.stdin.isTTY === true,
+                write: (text) => {
+                    process.stdout.write(text);
+                },
+                readLine: (prompt) => readline.question(prompt),
+            }, invocationName);
+            writeResult(result);
+        }
+        finally {
+            readline.close();
+        }
+        return;
+    }
+    writeResult(runPersonaCli(args, {
+        cwd: process.cwd(),
+        env: process.env,
+        invocationName,
+    }));
+}
+function isCliEntrypoint() {
+    const entrypoint = process.argv[1];
+    if (entrypoint === undefined) {
+        return false;
+    }
+    const normalized = entrypoint.replace(/\\/g, "/");
+    return entrypoint === fileURLToPath(import.meta.url) || normalized.endsWith("/persona-harness") || normalized.endsWith("/ph");
+}
+if (isCliEntrypoint()) {
+    runCliEntrypoint().catch((error) => {
+        if (error instanceof Error) {
+            process.stderr.write(`${error.message}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        throw error;
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+type InitOptions = {
+    readonly projectDir?: string;
+    readonly packageRoot?: string;
+};
+export type InitResult = {
+    readonly projectDir: string;
+    readonly packageRoot: string;
+    readonly pluginPath: string;
+    readonly installed: readonly string[];
+    readonly backups: readonly string[];
+    readonly evidenceCopied: false;
+};
+export declare function initializePersonaHarness(options?: InitOptions): InitResult;
+export declare function formatInitResult(result: InitResult): string;
+export declare function runInitCommand(options?: InitOptions): {
+    readonly status: number;
+    readonly stdout: string;
+    readonly stderr: string;
+};
+export {};