jouzu 0.0.1 → 0.1.0

package/dist/resume.js

@@ -0,0 +1,23 @@
+const ANSI_SEQUENCE = String.raw `\x1B\[[0-?]*[ -/]*[@-~]`;
+const PI_RESUME_HINT = new RegExp(String.raw `(To resume this session:(?:${ANSI_SEQUENCE})*[\t ]+)pi[^\r\n]*[\t ]--session[\t ]+([A-Za-z0-9._-]+)(?=\r?\n|$)`, "g");
+/** Replace Pi's process-level exit hint without changing stock Pi or its session files. */
+export function rewriteResumeHint(text) {
+    return text.replace(PI_RESUME_HINT, "$1jz --session $2");
+}
+/** Scope the exit-hint adapter to the pinned Pi runtime invocation. */
+export async function withJouzuResumeHint(operation) {
+    const originalWrite = process.stdout.write;
+    const jouzuWrite = function (chunk, ...args) {
+        const output = typeof chunk === "string" ? rewriteResumeHint(chunk) : chunk;
+        return Reflect.apply(originalWrite, this, [output, ...args]);
+    };
+    process.stdout.write = jouzuWrite;
+    try {
+        return await operation();
+    }
+    finally {
+        if (process.stdout.write === jouzuWrite)
+            process.stdout.write = originalWrite;
+    }
+}
+//# sourceMappingURL=resume.js.map

package/dist/resume.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume.js","sourceRoot":"","sources":["../src/resume.ts"],"names":[],"mappings":"AAEA,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAA,yBAAyB,CAAC;AAC1D,MAAM,cAAc,GAAG,IAAI,MAAM,CAChC,MAAM,CAAC,GAAG,CAAA,8BAA8B,aAAa,qEAAqE,EAC1H,GAAG,CACH,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,mBAAmB,CAAC,CAAC;AAC1D,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAI,SAA4B;IACxE,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IAC3C,MAAM,UAAU,GAAG,UAAoC,KAA0B,EAAE,GAAG,IAAe;QACpG,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5E,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAY,CAAC;IACzE,CAAgC,CAAC;IAEjC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,UAAU,CAAC;IAClC,IAAI,CAAC;QACJ,OAAO,MAAM,SAAS,EAAE,CAAC;IAC1B,CAAC;YAAS,CAAC;QACV,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,UAAU;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,aAAa,CAAC;IAC/E,CAAC;AACF,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,18 @@
+import type { ProfileId } from "./args.js";
+import type { JouzuPaths } from "./paths.js";
+interface ProfileSelection {
+    id: ProfileId;
+    source: "command line" | "environment" | "profile state" | "saved choice" | "first-run choice" | "default";
+    appliedManifestSha256?: string;
+    needsFirstRunInput: boolean;
+}
+export interface ProfileResolutionOptions {
+    explicitProfile?: ProfileId;
+    env?: NodeJS.ProcessEnv;
+    allowSavedChoice?: boolean;
+    interactiveStartup?: boolean;
+}
+export type { ProfileSelection };
+export declare function resolveProfileSelection(paths: JouzuPaths, options?: ProfileResolutionOptions): ProfileSelection;
+export declare function configurePiProcess(paths: JouzuPaths): void;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,UAAU,gBAAgB;IACzB,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,cAAc,GAAG,aAAa,GAAG,eAAe,GAAG,cAAc,GAAG,kBAAkB,GAAG,SAAS,CAAC;IAC3G,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,wBAAwB;IACxC,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,YAAY,EAAE,gBAAgB,EAAE,CAAC;AAMjC,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,wBAA6B,GAAG,gBAAgB,CAgDnH;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAO1D"}

package/dist/runtime.js

@@ -0,0 +1,59 @@
+import { join } from "node:path";
+import { readProfileChoice } from "./profile-choice.js";
+import { readProfileState } from "./profile-manager.js";
+function isProfileId(value) {
+    return value === "core" || value === "ja";
+}
+export function resolveProfileSelection(paths, options = {}) {
+    const state = readProfileState(paths.profileStatePath);
+    const explicitProfile = options.explicitProfile;
+    const env = options.env ?? process.env;
+    if (explicitProfile) {
+        return {
+            id: explicitProfile,
+            source: "command line",
+            appliedManifestSha256: state?.activeProfile === explicitProfile && typeof state.manifestSha256 === "string"
+                ? state.manifestSha256
+                : undefined,
+            needsFirstRunInput: false,
+        };
+    }
+    if (isProfileId(env.JOUZU_PROFILE)) {
+        return {
+            id: env.JOUZU_PROFILE,
+            source: "environment",
+            appliedManifestSha256: state?.activeProfile === env.JOUZU_PROFILE && typeof state.manifestSha256 === "string"
+                ? state.manifestSha256
+                : undefined,
+            needsFirstRunInput: false,
+        };
+    }
+    const interactiveStartup = options.interactiveStartup === true;
+    if (isProfileId(state?.activeProfile)) {
+        const savedChoice = interactiveStartup && state.activeProfile === "core"
+            ? readProfileChoice(join(paths.stateDir, "profile-choice.json"))
+            : undefined;
+        return {
+            id: state.activeProfile,
+            source: "profile state",
+            appliedManifestSha256: typeof state.manifestSha256 === "string" ? state.manifestSha256 : undefined,
+            needsFirstRunInput: interactiveStartup && state.activeProfile === "core" && savedChoice === undefined,
+        };
+    }
+    if (options.allowSavedChoice !== false) {
+        const savedChoice = readProfileChoice(join(paths.stateDir, "profile-choice.json"));
+        if (savedChoice) {
+            return { id: savedChoice.profile, source: "saved choice", needsFirstRunInput: false };
+        }
+    }
+    return { id: "core", source: "default", needsFirstRunInput: interactiveStartup };
+}
+export function configurePiProcess(paths) {
+    process.title = "jouzu";
+    process.env.AI_AGENT = "jouzu";
+    process.env.PI_CODING_AGENT = "true";
+    process.env.PI_CODING_AGENT_DIR = paths.agentDir;
+    process.env.PI_CODING_AGENT_SESSION_DIR = paths.sessionDir;
+    process.env.PI_SKIP_VERSION_CHECK = "1";
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/state-lock.d.ts

@@ -0,0 +1,39 @@
+/** Stale threshold after which a dead or owner-unknown lock may be recovered. */
+export declare const STATE_LOCK_STALE_MS: number;
+export interface StateLockRecord {
+    pid: number;
+    startedAt: string;
+    token: string;
+}
+export type StateLockStatus = "free" | "held-live" | "held-dead" | "owner-unknown" | "invalid";
+export interface StateLockInspection {
+    exists: boolean;
+    status: StateLockStatus;
+    ageMs: number | null;
+}
+export interface AcquireStateLockOptions {
+    path: string;
+    staleMs?: number;
+    describe: string;
+    now?: Date;
+    /** Maps a busy inspection to the caller's domain-specific error. */
+    onBusy: (inspection: StateLockInspection) => Error;
+}
+/**
+ * Inspect a state lock without acquiring it. An empty or unparsable legacy
+ * lock is classified as owner-unknown; its age is approximated from the file
+ * modification time because no started-at record exists.
+ */
+export declare function inspectStateLock(path: string, now: Date): StateLockInspection;
+/**
+ * Acquire a state lock shared by the updater, profile, and keybinding
+ * operations. The lock records a PID, started-at timestamp, and a release
+ * token. A lock held by a live process is always refused; a dead owner's lock
+ * or an owner-unknown legacy lock is refused while younger than the stale
+ * threshold and recovered automatically once it is older, without deleting a
+ * successor's lock. Returns a token-matched release function.
+ */
+export declare function acquireStateLock(options: AcquireStateLockOptions): () => void;
+/** Human-readable one-line description of a lock for doctor output. */
+export declare function describeStateLock(path: string, staleMs: number, now: Date): string;
+//# sourceMappingURL=state-lock.d.ts.map

package/dist/state-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-lock.d.ts","sourceRoot":"","sources":["../src/state-lock.ts"],"names":[],"mappings":"AAcA,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,QAAiB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,eAAe,GAAG,SAAS,CAAC;AAE/F,MAAM,WAAW,mBAAmB;IACnC,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,oEAAoE;IACpE,MAAM,EAAE,CAAC,UAAU,EAAE,mBAAmB,KAAK,KAAK,CAAC;CACnD;AAWD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,mBAAmB,CAwC7E;AAWD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,IAAI,CAkC7E;AASD,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAclF"}

package/dist/state-lock.js

@@ -0,0 +1,143 @@
+import { randomUUID } from "node:crypto";
+import { closeSync, existsSync, fsyncSync, lstatSync, openSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+import { ensurePrivateDirectory, validatePrivateDirectory } from "./private-fs.js";
+/** Stale threshold after which a dead or owner-unknown lock may be recovered. */
+export const STATE_LOCK_STALE_MS = 30 * 60 * 1000;
+function pidIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error instanceof Error && "code" in error && error.code === "EPERM";
+    }
+}
+/**
+ * Inspect a state lock without acquiring it. An empty or unparsable legacy
+ * lock is classified as owner-unknown; its age is approximated from the file
+ * modification time because no started-at record exists.
+ */
+export function inspectStateLock(path, now) {
+    try {
+        validatePrivateDirectory(dirname(path));
+    }
+    catch {
+        return { exists: true, status: "invalid", ageMs: null };
+    }
+    if (!existsSync(path))
+        return { exists: false, status: "free", ageMs: null };
+    try {
+        const metadata = lstatSync(path);
+        if (!metadata.isFile() || metadata.isSymbolicLink()) {
+            return { exists: true, status: "invalid", ageMs: null };
+        }
+        let record = null;
+        try {
+            const parsed = JSON.parse(readFileSync(path, "utf8"));
+            if (typeof parsed.pid === "number" &&
+                typeof parsed.startedAt === "string" &&
+                typeof parsed.token === "string" &&
+                Number.isFinite(Date.parse(parsed.startedAt))) {
+                record = { pid: parsed.pid, startedAt: parsed.startedAt, token: parsed.token };
+            }
+        }
+        catch { }
+        if (record === null) {
+            let ageMs = null;
+            try {
+                ageMs = now.getTime() - lstatSync(path).mtimeMs;
+            }
+            catch { }
+            return { exists: true, status: "owner-unknown", ageMs };
+        }
+        const ageMs = now.getTime() - Date.parse(record.startedAt);
+        return {
+            exists: true,
+            status: pidIsAlive(record.pid) ? "held-live" : "held-dead",
+            ageMs,
+        };
+    }
+    catch {
+        return { exists: false, status: "free", ageMs: null };
+    }
+}
+function releaseToken(path, token) {
+    try {
+        const metadata = lstatSync(path);
+        if (!metadata.isFile() || metadata.isSymbolicLink())
+            return;
+        const parsed = JSON.parse(readFileSync(path, "utf8"));
+        if (parsed.token === token)
+            unlinkSync(path);
+    }
+    catch { }
+}
+/**
+ * Acquire a state lock shared by the updater, profile, and keybinding
+ * operations. The lock records a PID, started-at timestamp, and a release
+ * token. A lock held by a live process is always refused; a dead owner's lock
+ * or an owner-unknown legacy lock is refused while younger than the stale
+ * threshold and recovered automatically once it is older, without deleting a
+ * successor's lock. Returns a token-matched release function.
+ */
+export function acquireStateLock(options) {
+    const now = options.now ?? new Date();
+    const staleMs = options.staleMs ?? STATE_LOCK_STALE_MS;
+    ensurePrivateDirectory(dirname(options.path));
+    const token = randomUUID();
+    const record = { pid: process.pid, startedAt: now.toISOString(), token };
+    const writeNew = () => {
+        const descriptor = openSync(options.path, "wx", 0o600);
+        writeFileSync(descriptor, `${JSON.stringify(record)}\n`);
+        fsyncSync(descriptor);
+        closeSync(descriptor);
+    };
+    try {
+        writeNew();
+    }
+    catch (error) {
+        if (!(error instanceof Error && "code" in error && error.code === "EEXIST"))
+            throw error;
+        const inspection = inspectStateLock(options.path, now);
+        if (inspection.status === "free") {
+            writeNew();
+            return () => releaseToken(options.path, token);
+        }
+        if (inspection.status === "held-live" || inspection.status === "invalid") {
+            throw options.onBusy(inspection);
+        }
+        // held-dead or owner-unknown: refuse while younger than the threshold,
+        // recover automatically once stale.
+        if (inspection.ageMs === null || inspection.ageMs <= staleMs) {
+            throw options.onBusy(inspection);
+        }
+        unlinkSync(options.path);
+        writeNew();
+        return () => releaseToken(options.path, token);
+    }
+    return () => releaseToken(options.path, token);
+}
+function ageText(ageMs) {
+    const totalSeconds = Math.max(0, Math.floor(ageMs / 1000));
+    const minutes = Math.floor(totalSeconds / 60);
+    const seconds = totalSeconds % 60;
+    return minutes > 0 ? `${minutes}m ${seconds}s` : `${seconds}s`;
+}
+/** Human-readable one-line description of a lock for doctor output. */
+export function describeStateLock(path, staleMs, now) {
+    const inspection = inspectStateLock(path, now);
+    switch (inspection.status) {
+        case "free":
+            return "free";
+        case "held-live":
+            return `held by a live process (${ageText(inspection.ageMs ?? 0)})`;
+        case "held-dead":
+            return `left by a dead process (${ageText(inspection.ageMs ?? 0)}; recoverable after ${ageText(staleMs)})`;
+        case "owner-unknown":
+            return `owner unknown (${ageText(inspection.ageMs ?? 0)}; recoverable after ${ageText(staleMs)})`;
+        case "invalid":
+            return "invalid (not a regular lock file)";
+    }
+}
+//# sourceMappingURL=state-lock.js.map

package/dist/state-lock.js.map

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

package/dist/updater.d.ts

@@ -0,0 +1,113 @@
+import type { JouzuPaths } from "./paths.js";
+declare const UPDATE_POLICIES: readonly ["auto-restart", "notify", "off"];
+declare const UPDATE_RESULTS: readonly ["never", "current", "available", "updated", "failed"];
+export type UpdatePolicy = (typeof UPDATE_POLICIES)[number];
+export type UpdateResult = (typeof UPDATE_RESULTS)[number];
+export type UpdateInstallChannel = "global-npm" | "local-npm" | "ephemeral-npx" | "source" | "other";
+export interface UpdateState {
+    schemaVersion: 1;
+    policy: UpdatePolicy;
+    channel: "latest";
+    lastCheckedAt: string | null;
+    nextCheckAt: string | null;
+    lastResult: UpdateResult;
+    installedVersion: string;
+    latestVersion: string | null;
+    latestIntegrity: string | null;
+    previousVersion: string | null;
+    lastUpdatedAt: string | null;
+    lastErrorCode: string | null;
+}
+export interface RegistryRelease {
+    version: string;
+    integrity: string;
+}
+export interface UpdateCheckResult extends RegistryRelease {
+    status: "current" | "available";
+    installedVersion: string;
+}
+export interface UpdateStatus {
+    policy: UpdatePolicy;
+    installChannel: UpdateInstallChannel;
+    startupEligible: boolean;
+    state: UpdateState;
+}
+export interface NpmRunResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+export type NpmRunner = (args: string[], timeoutMs: number) => NpmRunResult;
+export interface UpdaterOptions {
+    paths: JouzuPaths;
+    currentVersion: string;
+    executable: string;
+    packageRoot?: string;
+    env?: NodeJS.ProcessEnv;
+    platform?: NodeJS.Platform;
+    now?: () => Date;
+    runNpm?: NpmRunner;
+    verifyInstalled?: (expectedVersion: string) => void;
+    report?: (message: string) => void;
+}
+export interface StartupUpdateResult {
+    action: "continue" | "restart";
+    version?: string;
+    message?: string;
+}
+export declare class UpdateError extends Error {
+    readonly code: string;
+    readonly exitCode: number;
+    readonly fatal: boolean;
+    constructor(message: string, code: string, options?: {
+        exitCode?: number;
+        fatal?: boolean;
+    });
+}
+export declare function compareSemver(left: string, right: string): number;
+export declare function updateStatePath(paths: JouzuPaths): string;
+export declare function readUpdateState(path: string, currentVersion: string): UpdateState;
+export declare function classifyInstallChannel(options: {
+    packageRoot: string;
+    globalNpmRoot?: string;
+    platform?: NodeJS.Platform;
+}): UpdateInstallChannel;
+export declare class JouzuUpdater {
+    private readonly paths;
+    private readonly currentVersion;
+    private readonly executable;
+    private readonly packageRoot;
+    private readonly env;
+    private readonly platform;
+    private readonly now;
+    private readonly runNpm;
+    private readonly verifyInstalled;
+    private readonly report;
+    private cachedInstallChannel;
+    constructor(options: UpdaterOptions);
+    private readState;
+    private writeState;
+    private recordFailure;
+    private globalNpmRoot;
+    installChannel(): UpdateInstallChannel;
+    status(): UpdateStatus;
+    setPolicy(policy: UpdatePolicy): UpdateState;
+    check(): UpdateCheckResult;
+    private createDownloadDirectory;
+    private pack;
+    private installTarball;
+    apply(checkResult?: UpdateCheckResult): {
+        changed: boolean;
+        version: string;
+    };
+    startup(): StartupUpdateResult;
+}
+export declare function relaunchUpdatedJouzu(options: {
+    executable: string;
+    args: string[];
+    env?: NodeJS.ProcessEnv;
+}): number;
+export declare function formatUpdateStatus(status: UpdateStatus): string;
+export {};
+//# sourceMappingURL=updater.d.ts.map

package/dist/updater.d.ts.map

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