@nac3/forge-cli 0.2.0-alpha.1

package/dist/core/projects_sync.js

@@ -0,0 +1,278 @@
+/**
+ * GitHub-anchored project sync (PLAN #10, soft #5).
+ *
+ * The user owns a private GitHub repo `yujin-state` whose
+ * `projects.json` file is the cross-device truth bus for their
+ * Forge project registry. This module:
+ *
+ *   - Bootstraps the repo + file on first sync (creates the
+ *     repo + commits an empty projects.json).
+ *   - Pulls the remote file via the GitHub Contents API.
+ *   - Merges per-slug into the local registry using
+ *     last-writer-wins on `updated_at`.
+ *   - Pushes the merged result back.
+ *
+ * Per-device fields (path, mode-on-this-device) are STRIPPED
+ * before push -- only the cross-device fields (slug,
+ * github_repo, target, mode-default, last_active_at,
+ * updated_at) ride.
+ *
+ * Auth: vault slot `github_token` with `repo` scope. Same slot
+ * used by `yf repo init` + the chat tools.
+ *
+ * Loud failures: missing vault slot, non-2xx API, optimistic
+ * concurrency conflict (412) -> retry once after re-pulling.
+ *
+ * ASCII-only.
+ */
+import { readRegistry, writeRegistry, } from './projects.js';
+const GITHUB_API = 'https://api.github.com';
+const STATE_REPO = 'yujin-state';
+const STATE_FILE = 'projects.json';
+const STATE_FILE_SCHEMA = 'yujin-state/projects.json/v1';
+/* ------- Strip device-local fields before push ------- */
+export function toRemoteEntry(p) {
+    return {
+        slug: p.slug,
+        ...(p.github_repo ? { github_repo: p.github_repo } : {}),
+        ...(p.target ? { target: p.target } : {}),
+        ...(p.mode ? { mode: p.mode } : {}),
+        ...(p.last_active_at ? { last_active_at: p.last_active_at } : {}),
+        updated_at: p.updated_at ?? new Date().toISOString(),
+    };
+}
+/** Per-slug merge: keep the entry with the higher updated_at.
+ *  Returns [merged, classifications] -- classifications used
+ *  by SyncResult. */
+export function mergeRegistries(local, remote) {
+    const localBySlug = new Map(local.projects.map((p) => [p.slug, p]));
+    const remoteBySlug = new Map(remote.projects.map((p) => [p.slug, p]));
+    const allSlugs = new Set([...localBySlug.keys(), ...remoteBySlug.keys()]);
+    const pulled_new = [];
+    const pulled_updated = [];
+    const pushed = [];
+    const mergedProjects = [];
+    for (const slug of allSlugs) {
+        const lo = localBySlug.get(slug);
+        const re = remoteBySlug.get(slug);
+        if (lo && !re) {
+            /* Only local -> push it. */
+            mergedProjects.push(lo);
+            pushed.push(slug);
+            continue;
+        }
+        if (re && !lo) {
+            /* Only remote -> pull as remote_only entry. */
+            mergedProjects.push({
+                slug: re.slug,
+                path: '', /* unknown on this device */
+                remote_only: true,
+                ...(re.github_repo ? { github_repo: re.github_repo } : {}),
+                ...(re.target ? { target: re.target } : {}),
+                ...(re.mode ? { mode: re.mode } : {}),
+                ...(re.last_active_at ? { last_active_at: re.last_active_at } : {}),
+                updated_at: re.updated_at,
+            });
+            pulled_new.push(slug);
+            continue;
+        }
+        /* Both sides have it -- compare timestamps. */
+        const loStamp = lo.updated_at ?? '';
+        const reStamp = re.updated_at ?? '';
+        if (reStamp > loStamp) {
+            mergedProjects.push({
+                ...lo,
+                github_repo: re.github_repo ?? lo.github_repo,
+                target: re.target ?? lo.target,
+                mode: re.mode ?? lo.mode,
+                last_active_at: re.last_active_at ?? lo.last_active_at,
+                updated_at: re.updated_at,
+            });
+            pulled_updated.push(slug);
+        }
+        else if (loStamp > reStamp) {
+            mergedProjects.push(lo);
+            pushed.push(slug);
+        }
+        else {
+            /* Equal -- no change either way. */
+            mergedProjects.push(lo);
+        }
+    }
+    return {
+        merged: { version: 1, active_slug: local.active_slug, projects: mergedProjects },
+        pulled_new,
+        pulled_updated,
+        pushed,
+    };
+}
+async function getOwnerLogin(token, fetchImpl) {
+    const r = await fetchImpl(GITHUB_API + '/user', {
+        headers: {
+            Authorization: 'Bearer ' + token,
+            Accept: 'application/vnd.github+json',
+            'User-Agent': 'yujin-forge',
+        },
+    });
+    if (!r.ok)
+        throw new Error('GitHub GET /user ' + r.status);
+    const j = await r.json();
+    return j.login;
+}
+async function createStateRepo(token, name, fetchImpl) {
+    const r = await fetchImpl(GITHUB_API + '/user/repos', {
+        method: 'POST',
+        headers: {
+            Authorization: 'Bearer ' + token,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'Content-Type': 'application/json',
+            'User-Agent': 'yujin-forge',
+        },
+        body: JSON.stringify({
+            name,
+            private: true,
+            auto_init: true,
+            description: 'Yujin Forge cross-device project state (managed by yf).',
+        }),
+    });
+    if (!r.ok) {
+        let body = '';
+        try {
+            body = await r.text();
+        }
+        catch { /* */ }
+        throw new Error('GitHub POST /user/repos ' + r.status + ': ' + body.slice(0, 300));
+    }
+}
+async function readRemoteState(token, owner, repoName, fetchImpl) {
+    const url = GITHUB_API + '/repos/' + owner + '/' + repoName + '/contents/' + STATE_FILE;
+    const r = await fetchImpl(url, {
+        headers: {
+            Authorization: 'Bearer ' + token,
+            Accept: 'application/vnd.github+json',
+            'User-Agent': 'yujin-forge',
+        },
+    });
+    if (r.status === 404) {
+        /* Distinguish "file missing inside existing repo" from
+         * "repo missing entirely" by probing the repo itself. */
+        const repoR = await fetchImpl(GITHUB_API + '/repos/' + owner + '/' + repoName, {
+            headers: {
+                Authorization: 'Bearer ' + token,
+                Accept: 'application/vnd.github+json',
+                'User-Agent': 'yujin-forge',
+            },
+        });
+        if (repoR.status === 404)
+            return { state: null, sha: null, repoMissing: true };
+        return { state: null, sha: null, repoMissing: false };
+    }
+    if (!r.ok)
+        throw new Error('GitHub GET contents ' + r.status);
+    const j = await r.json();
+    if (!j.content || j.encoding !== 'base64')
+        throw new Error('unexpected contents response shape');
+    const text = Buffer.from(j.content, 'base64').toString('utf8');
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch {
+        /* Treat a malformed remote file as empty state -- we will
+         * overwrite it. */
+        return { state: { version: 1, schema: STATE_FILE_SCHEMA, projects: [] }, sha: j.sha ?? null, repoMissing: false };
+    }
+    return { state: parsed, sha: j.sha ?? null, repoMissing: false };
+}
+async function writeRemoteState(token, owner, repoName, state, sha, fetchImpl) {
+    const url = GITHUB_API + '/repos/' + owner + '/' + repoName + '/contents/' + STATE_FILE;
+    const content = Buffer.from(JSON.stringify(state, null, 2) + '\n', 'utf8').toString('base64');
+    const body = {
+        message: 'yf sync ' + new Date().toISOString(),
+        content,
+    };
+    if (sha)
+        body.sha = sha;
+    const r = await fetchImpl(url, {
+        method: 'PUT',
+        headers: {
+            Authorization: 'Bearer ' + token,
+            Accept: 'application/vnd.github+json',
+            'X-GitHub-Api-Version': '2022-11-28',
+            'Content-Type': 'application/json',
+            'User-Agent': 'yujin-forge',
+        },
+        body: JSON.stringify(body),
+    });
+    if (!r.ok) {
+        let detail = '';
+        try {
+            detail = await r.text();
+        }
+        catch { /* */ }
+        throw new Error('GitHub PUT contents ' + r.status + ': ' + detail.slice(0, 300));
+    }
+}
+/** Run a full bidirectional sync. Caller orchestrates retries. */
+export async function syncProjects(opts = {}, deps) {
+    const fetchImpl = deps.fetchImpl ?? ((u, init) => globalThis.fetch(u, init));
+    const repoName = deps.stateRepoName ?? STATE_REPO;
+    const token = await deps.tokenProvider();
+    const owner = deps.ownerProvider ? await deps.ownerProvider() : await getOwnerLogin(token, fetchImpl);
+    /* 1. Read remote (bootstrap repo if missing). */
+    let remoteResult = await readRemoteState(token, owner, repoName, fetchImpl);
+    let bootstrapped = false;
+    if (remoteResult.repoMissing) {
+        await createStateRepo(token, repoName, fetchImpl);
+        bootstrapped = true;
+        /* After auto_init the repo has no projects.json yet. */
+        remoteResult = { state: null, sha: null, repoMissing: false };
+    }
+    const remoteState = remoteResult.state
+        ?? { version: 1, schema: STATE_FILE_SCHEMA, projects: [] };
+    /* 2. Merge. */
+    const local = await readRegistry();
+    const { merged, pulled_new, pulled_updated, pushed } = mergeRegistries(local, remoteState);
+    /* 3. Write local (unless pushOnly). */
+    if (!opts.pushOnly)
+        await writeRegistry(merged);
+    /* 4. Write remote (unless pullOnly). */
+    if (!opts.pullOnly) {
+        const nextRemote = {
+            version: 1, schema: STATE_FILE_SCHEMA,
+            projects: merged.projects.map(toRemoteEntry),
+        };
+        try {
+            await writeRemoteState(token, owner, repoName, nextRemote, remoteResult.sha, fetchImpl);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (/\b409\b|\b412\b|sha was/i.test(msg)) {
+                /* Concurrent write -- re-pull + retry once. */
+                const fresh = await readRemoteState(token, owner, repoName, fetchImpl);
+                const freshState = fresh.state ?? { version: 1, schema: STATE_FILE_SCHEMA, projects: [] };
+                const m2 = mergeRegistries(merged, freshState).merged;
+                if (!opts.pushOnly)
+                    await writeRegistry(m2);
+                const retryRemote = {
+                    version: 1, schema: STATE_FILE_SCHEMA,
+                    projects: m2.projects.map(toRemoteEntry),
+                };
+                await writeRemoteState(token, owner, repoName, retryRemote, fresh.sha, fetchImpl);
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return {
+        ok: true,
+        remote_repo: owner + '/' + repoName,
+        pulled_new,
+        pulled_updated,
+        pushed,
+        bootstrapped,
+    };
+}
+//# sourceMappingURL=projects_sync.js.map

package/dist/core/projects_sync.js.map

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

package/dist/core/remote_runner.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Remote runner -- bridges the cascade router's RouteDecision
+ * to an actual `yf <command>` execution against the chosen
+ * target.
+ *
+ * Three execution shapes:
+ *
+ *   laptop_lan      -> HTTP POST to <endpoint>/v1/exec with
+ *                      { command, args }; expect a JSON response.
+ *   cf_tunnel       -> same HTTP shape, just a different URL.
+ *   github_actions  -> dispatchWorkflow + poll fetchRunResult
+ *                      until done.
+ *
+ * The runner does NOT itself probe -- decideRoute (from
+ * cascade_router) has already done that. The runner is a thin
+ * executor with timeout, error normalisation, and a uniform
+ * { ok, exit, stdout, stderr, target, durationMs } shape so
+ * the chat UI can render the result without target-specific
+ * branching.
+ *
+ * ASCII-only.
+ */
+import { type ComputeClass, type CascadeEndpoints, type CascadeProbes, type RouteDecision } from './cascade_router.js';
+import { type DispatchResult } from './gha_dispatcher.js';
+export interface RunCommandResult {
+    ok: boolean;
+    exit: number;
+    stdout: string;
+    stderr: string;
+    /** Which target ran the command (or null when nothing was
+     *  reachable). */
+    target: RouteDecision['target'];
+    durationMs: number;
+    /** When ok=false, populated. */
+    error?: string;
+    /** Full RouteDecision audit -- helps debug "why this target?". */
+    route: RouteDecision;
+}
+export interface RunCommandInput {
+    command: string;
+    args?: string;
+}
+export interface RunCommandDeps {
+    fetchImpl?: typeof fetch;
+    /** GitHub PAT for the Actions fallback. */
+    githubToken?: string;
+    /** Override the GHA dispatch -- tests inject a stub. */
+    dispatchWorkflowImpl?: (repo: string, command: string, args: string, token: string) => Promise<DispatchResult>;
+    /** Override the GHA poll. Returns the final RunStatus + content
+     *  when ready, null while still pending. */
+    fetchRunResultImpl?: (repo: string, runId: string, token: string) => Promise<{
+        status: string;
+        stdout?: string;
+        stderr?: string;
+        exit?: number;
+        duration_seconds?: number;
+    } | null>;
+    /** Poll cadence + timeout for the GHA path. */
+    pollIntervalMs?: number;
+    ghaTimeoutMs?: number;
+    /** Per-HTTP-call timeout (laptop_lan + cf_tunnel). */
+    httpTimeoutMs?: number;
+    /** Clock injector for tests. */
+    now?: () => number;
+    /** Sleep injector for tests. */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Run a `yf <command> [args]` against the routed target. */
+export declare function runRemoteCommand(cmd: RunCommandInput, computeClass: ComputeClass, endpoints: CascadeEndpoints, probes: CascadeProbes, deps?: RunCommandDeps): Promise<RunCommandResult>;
+//# sourceMappingURL=remote_runner.d.ts.map

package/dist/core/remote_runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote_runner.d.ts","sourceRoot":"","sources":["../../src/core/remote_runner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,OAAO,EAAe,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpI,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE5F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;sBACkB;IAClB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,oBAAoB,CAAC,EAAE,CACrB,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KACvD,OAAO,CAAC,cAAc,CAAC,CAAC;IAC7B;gDAC4C;IAC5C,kBAAkB,CAAC,EAAE,CACnB,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KACvC,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACpH,+CAA+C;IAC/C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gCAAgC;IAChC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AA8ED,6DAA6D;AAC7D,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,eAAe,EACpB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,gBAAgB,EAC3B,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,gBAAgB,CAAC,CAmC3B"}

package/dist/core/remote_runner.js

@@ -0,0 +1,133 @@
+/**
+ * Remote runner -- bridges the cascade router's RouteDecision
+ * to an actual `yf <command>` execution against the chosen
+ * target.
+ *
+ * Three execution shapes:
+ *
+ *   laptop_lan      -> HTTP POST to <endpoint>/v1/exec with
+ *                      { command, args }; expect a JSON response.
+ *   cf_tunnel       -> same HTTP shape, just a different URL.
+ *   github_actions  -> dispatchWorkflow + poll fetchRunResult
+ *                      until done.
+ *
+ * The runner does NOT itself probe -- decideRoute (from
+ * cascade_router) has already done that. The runner is a thin
+ * executor with timeout, error normalisation, and a uniform
+ * { ok, exit, stdout, stderr, target, durationMs } shape so
+ * the chat UI can render the result without target-specific
+ * branching.
+ *
+ * ASCII-only.
+ */
+import { decideRoute } from './cascade_router.js';
+import { dispatchWorkflow, fetchRunResult } from './gha_dispatcher.js';
+function defaultSleep(ms) {
+    return new Promise((resolve) => {
+        const t = setTimeout(resolve, ms);
+        if (typeof t.unref === 'function') {
+            t.unref();
+        }
+    });
+}
+async function httpExec(endpoint, cmd, deps) {
+    const fetchImpl = deps.fetchImpl ?? ((u, init) => globalThis.fetch(u, init));
+    const url = endpoint.replace(/\/+$/, '') + '/v1/exec';
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), deps.httpTimeoutMs ?? 60_000);
+    try {
+        const r = await fetchImpl(url, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify({ command: cmd.command, args: cmd.args ?? '' }),
+            signal: ctrl.signal,
+        });
+        if (!r.ok) {
+            let detail = '';
+            try {
+                detail = await r.text();
+            }
+            catch { /* */ }
+            return { exit: 1, stdout: '', stderr: 'HTTP ' + r.status + ': ' + detail.slice(0, 400) };
+        }
+        const body = await r.json();
+        return {
+            exit: typeof body.exit === 'number' ? body.exit : 0,
+            stdout: typeof body.stdout === 'string' ? body.stdout : '',
+            stderr: typeof body.stderr === 'string' ? body.stderr : '',
+        };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+async function ghaExec(repo, cmd, deps) {
+    if (!deps.githubToken) {
+        return { exit: 1, stdout: '', stderr: 'github_actions target requested but no githubToken provided' };
+    }
+    const dispatch = deps.dispatchWorkflowImpl ?? dispatchWorkflow;
+    const poll = deps.fetchRunResultImpl ?? fetchRunResult;
+    const sleep = deps.sleep ?? defaultSleep;
+    const now = deps.now ?? Date.now;
+    const interval = deps.pollIntervalMs ?? 5_000;
+    const timeout = deps.ghaTimeoutMs ?? 30 * 60 * 1000;
+    const disp = await dispatch(repo, cmd.command, cmd.args ?? '', deps.githubToken);
+    if (!disp.ok || !disp.run_id) {
+        return { exit: 1, stdout: '', stderr: 'dispatch failed: ' + (disp.error ?? 'unknown') };
+    }
+    const startedAt = now();
+    while (now() - startedAt < timeout) {
+        const result = await poll(repo, disp.run_id, deps.githubToken);
+        if (result) {
+            const exit = typeof result.exit === 'number' ? result.exit : (result.status === 'success' ? 0 : 1);
+            return {
+                exit,
+                stdout: result.stdout ?? '',
+                stderr: result.stderr ?? '',
+            };
+        }
+        await sleep(interval);
+    }
+    return { exit: 1, stdout: '', stderr: 'github_actions timed out after ' + timeout + 'ms' };
+}
+/** Run a `yf <command> [args]` against the routed target. */
+export async function runRemoteCommand(cmd, computeClass, endpoints, probes, deps = {}) {
+    const t0 = (deps.now ?? Date.now)();
+    const route = await decideRoute(computeClass, endpoints, probes, {});
+    if (!route.target) {
+        return {
+            ok: false, exit: 1, stdout: '', stderr: route.reason,
+            target: null, durationMs: (deps.now ?? Date.now)() - t0,
+            error: route.reason, route,
+        };
+    }
+    try {
+        let payload;
+        if (route.target === 'laptop_lan' || route.target === 'cf_tunnel') {
+            if (!route.endpoint)
+                throw new Error(route.target + ' picked but endpoint missing');
+            payload = await httpExec(route.endpoint, cmd, deps);
+        }
+        else {
+            /* github_actions */
+            if (!route.endpoint)
+                throw new Error('github_actions picked but no repo configured');
+            payload = await ghaExec(route.endpoint, cmd, deps);
+        }
+        return {
+            ok: payload.exit === 0,
+            exit: payload.exit, stdout: payload.stdout, stderr: payload.stderr,
+            target: route.target, durationMs: (deps.now ?? Date.now)() - t0,
+            route,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false, exit: 1, stdout: '', stderr: err instanceof Error ? err.message : String(err),
+            target: route.target, durationMs: (deps.now ?? Date.now)() - t0,
+            error: err instanceof Error ? err.message : String(err),
+            route,
+        };
+    }
+}
+//# sourceMappingURL=remote_runner.js.map

package/dist/core/remote_runner.js.map

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

package/dist/core/repo_state.d.ts

@@ -0,0 +1,24 @@
+export interface RepoState {
+    /** Absolute directory we probed. */
+    path: string;
+    /** True if `.git/` exists as a directory or worktree pointer file. */
+    is_git: boolean;
+    /** Remote URLs (origin first, then alphabetical). Empty when
+     *  no remotes are configured. */
+    remotes: string[];
+    /** Convenience flag: at least one remote whose host is github.com. */
+    has_github_remote: boolean;
+}
+/** True when the directory or one of its ancestors contains a
+ *  `.git/` entry. Mirrors `git rev-parse --is-inside-work-tree`
+ *  without spawning git -- safer + faster on a hot path. */
+export declare function isGitRepo(dir: string): Promise<boolean>;
+/** Read remotes from `git remote -v`. Empty array when the dir
+ *  isn't a repo or git is missing. */
+export declare function listRemotes(dir: string): Promise<string[]>;
+export declare function inspectRepoState(dir: string): Promise<RepoState>;
+/** Single-line stdout-friendly warning summary for chat /
+ *  projects callers. Empty string when the dir IS a repo with
+ *  any remote -- callers print nothing in that case. */
+export declare function formatRepoStateWarning(state: RepoState): string;
+//# sourceMappingURL=repo_state.d.ts.map

package/dist/core/repo_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo_state.d.ts","sourceRoot":"","sources":["../../src/core/repo_state.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,SAAS;IACxB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB;qCACiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,sEAAsE;IACtE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED;;4DAE4D;AAC5D,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmB7D;AAED;sCACsC;AACtC,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BhE;AAED,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAMtE;AAED;;wDAEwD;AACxD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAS/D"}

package/dist/core/repo_state.js

@@ -0,0 +1,109 @@
+/**
+ * Repo-state inspection for the "trabajar sin repo" warning.
+ *
+ * Forge prefers projects to live in a git repo (any remote --
+ * GitHub, GitLab, Bitbucket, local-only). When the user starts
+ * Forge against a plain directory we still let them work, but
+ * we surface a one-time warning explaining the trade-offs:
+ *
+ *   - No cross-device sync (yujin-state can't follow you).
+ *   - No automatic Forge backup.
+ *   - No `yf license cancel`-style audit trail.
+ *
+ * Pablo 2026-05-26: "permite trabajar sin repo, solo local,
+ * con advertencia."
+ *
+ * This module is pure I/O on `.git/` and `git remote -v`; it
+ * never mutates state, never executes git for write paths.
+ *
+ * ASCII-only.
+ */
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { spawn } from 'node:child_process';
+/** True when the directory or one of its ancestors contains a
+ *  `.git/` entry. Mirrors `git rev-parse --is-inside-work-tree`
+ *  without spawning git -- safer + faster on a hot path. */
+export async function isGitRepo(dir) {
+    let cur = path.resolve(dir);
+    const root = path.parse(cur).root;
+    while (true) {
+        const candidate = path.join(cur, '.git');
+        try {
+            const st = await fs.stat(candidate);
+            if (st.isDirectory())
+                return true;
+            /* Worktrees + submodules use a file with `gitdir: ` prefix. */
+            if (st.isFile()) {
+                const buf = await fs.readFile(candidate, 'utf8');
+                if (buf.startsWith('gitdir:'))
+                    return true;
+            }
+        }
+        catch { /* not present at this level */ }
+        if (cur === root)
+            return false;
+        const next = path.dirname(cur);
+        if (next === cur)
+            return false;
+        cur = next;
+    }
+}
+/** Read remotes from `git remote -v`. Empty array when the dir
+ *  isn't a repo or git is missing. */
+export async function listRemotes(dir) {
+    if (!(await isGitRepo(dir)))
+        return [];
+    return new Promise((resolve) => {
+        const proc = spawn('git', ['-C', dir, 'remote', '-v'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stdout = '';
+        proc.stdout.on('data', (b) => { stdout += b.toString('utf-8'); });
+        proc.on('error', () => resolve([]));
+        proc.on('close', () => {
+            const seen = new Set();
+            const out = [];
+            for (const line of stdout.split('\n')) {
+                const m = line.match(/^\S+\s+(\S+)\s+\(fetch\)/);
+                if (m && m[1] && !seen.has(m[1])) {
+                    seen.add(m[1]);
+                    out.push(m[1]);
+                }
+            }
+            /* origin first when present, rest alphabetical. */
+            const origin = out.find((u) => /\/origin(\.git)?$/.test(u));
+            const sorted = out.sort();
+            if (origin) {
+                const idx = sorted.indexOf(origin);
+                if (idx > 0) {
+                    sorted.splice(idx, 1);
+                    sorted.unshift(origin);
+                }
+            }
+            resolve(sorted);
+        });
+    });
+}
+export async function inspectRepoState(dir) {
+    const abs = path.resolve(dir);
+    const is_git = await isGitRepo(abs);
+    const remotes = is_git ? await listRemotes(abs) : [];
+    const has_github_remote = remotes.some((u) => /github\.com[/:]/.test(u));
+    return { path: abs, is_git, remotes, has_github_remote };
+}
+/** Single-line stdout-friendly warning summary for chat /
+ *  projects callers. Empty string when the dir IS a repo with
+ *  any remote -- callers print nothing in that case. */
+export function formatRepoStateWarning(state) {
+    if (state.is_git && state.remotes.length > 0)
+        return '';
+    if (state.is_git && state.remotes.length === 0) {
+        return 'WARNING: git repo with no remote -- cross-device sync + Forge backup are OFF. '
+            + 'Run `yf repo init --remote` (or push to a hosted remote manually) to enable them.';
+    }
+    return 'WARNING: ' + state.path + ' is NOT a git repo. '
+        + 'You can still work locally, but cross-device sync + Forge backup are OFF. '
+        + 'Run `yf repo init` to convert this folder into a git repo (optionally with a GitHub remote).';
+}
+//# sourceMappingURL=repo_state.js.map

package/dist/core/repo_state.js.map

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