@kenkaiiii/ggcoder-eyes 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 KenKai
+
+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/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,328 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { appendEntry, isEyesActive, journalCount, readJournal, updateEntry, } from "./journal.js";
+import { readManifest as readManifestShared } from "./manifest.js";
+// In dev: __dirname = packages/ggcoder-eyes/src. After build: dist/.
+// Probes + shared live at ../probes and ../shared relative to the built file.
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = resolve(__dirname, "..");
+const PROBES_DIR = join(PKG_ROOT, "probes");
+const SHARED_DIR = join(PKG_ROOT, "shared");
+const EYES_DIR = resolve(process.cwd(), ".gg/eyes");
+const MANIFEST = join(EYES_DIR, "manifest.json");
+const GITIGNORE_ENTRIES = [
+    ".gg/eyes/out/",
+    ".gg/eyes/state/",
+    ".gg/eyes/bin/",
+    ".gg/eyes/recordings/",
+    ".gg/eyes/auth/",
+    ".gg/eyes/remote.json",
+    ".gg/eyes/_lib.sh",
+    ".gg/eyes/_redact.sh",
+];
+function readManifest() {
+    return readManifestShared(process.cwd());
+}
+function writeManifest(m) {
+    mkdirSync(EYES_DIR, { recursive: true });
+    writeFileSync(MANIFEST, JSON.stringify(m, null, 2));
+}
+function ensureGitignore() {
+    const gi = resolve(process.cwd(), ".gitignore");
+    const existing = existsSync(gi) ? readFileSync(gi, "utf8") : "";
+    const missing = GITIGNORE_ENTRIES.filter((e) => !existing.includes(e));
+    if (missing.length) {
+        const suffix = (existing.endsWith("\n") || !existing ? "" : "\n") +
+            "\n# ggcoder-eyes\n" +
+            missing.join("\n") +
+            "\n";
+        writeFileSync(gi, existing + suffix);
+    }
+}
+function sh(cmd, args, opts = {}) {
+    const r = spawnSync(cmd, args, {
+        cwd: opts.cwd ?? process.cwd(),
+        env: { ...process.env, EYES_PROJECT_ROOT: process.cwd(), ...(opts.env ?? {}) },
+        stdio: ["ignore", "pipe", "inherit"],
+        encoding: "utf8",
+    });
+    return { stdout: r.stdout?.trim() ?? "", code: r.status ?? 1 };
+}
+function capabilityDirs() {
+    return readdirSync(PROBES_DIR).filter((d) => {
+        const p = join(PROBES_DIR, d);
+        return existsSync(join(p, "install.sh"));
+    });
+}
+function doInit() {
+    mkdirSync(EYES_DIR, { recursive: true });
+    mkdirSync(join(EYES_DIR, "out"), { recursive: true });
+    mkdirSync(join(EYES_DIR, "state"), { recursive: true });
+    mkdirSync(join(EYES_DIR, "bin"), { recursive: true });
+    // Copy shared infra
+    for (const f of ["_lib.sh", "_redact.sh"]) {
+        const src = join(SHARED_DIR, f);
+        const dst = join(EYES_DIR, f);
+        writeFileSync(dst, readFileSync(src));
+        sh("chmod", ["+x", dst]);
+    }
+    ensureGitignore();
+    if (!existsSync(MANIFEST))
+        writeManifest({ version: 1, probes: [] });
+    console.log(`initialized: ${EYES_DIR}`);
+}
+function doDetect() {
+    const out = {};
+    for (const cap of capabilityDirs()) {
+        const detect = join(PROBES_DIR, cap, "detect.sh");
+        if (!existsSync(detect)) {
+            // Universal capabilities without detect.sh (e.g. http) — single universal impl.
+            out[cap] = { candidates: ["*"], primary: "*" };
+            continue;
+        }
+        const r = sh("bash", [detect]);
+        if (r.code === 0 && r.stdout) {
+            try {
+                out[cap] = JSON.parse(r.stdout);
+            }
+            catch {
+                out[cap] = { candidates: [], primary: "" };
+            }
+        }
+        else {
+            out[cap] = { candidates: [], primary: "" };
+        }
+    }
+    console.log(JSON.stringify(out, null, 2));
+}
+function doInstall(args) {
+    const cap = args[0];
+    if (!cap) {
+        console.error("usage: ggcoder-eyes install <capability> [--impl <name>] [--as <script-name>]");
+        process.exit(1);
+    }
+    let impl;
+    let asName;
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === "--impl")
+            impl = args[++i];
+        else if (args[i] === "--as")
+            asName = args[++i];
+    }
+    const capDir = join(PROBES_DIR, cap);
+    if (!existsSync(capDir)) {
+        console.error(`unknown capability: ${cap}. known: ${capabilityDirs().join(", ")}`);
+        process.exit(1);
+    }
+    // If no impl given, consult detect.sh
+    if (!impl) {
+        const detectPath = join(capDir, "detect.sh");
+        if (existsSync(detectPath)) {
+            const r = sh("bash", [detectPath]);
+            try {
+                impl = JSON.parse(r.stdout).primary;
+            }
+            catch {
+                /* fall through */
+            }
+        }
+        else {
+            // Universal probe — pick the only impl
+            const impls = readdirSync(join(capDir, "impl")).filter((f) => f.endsWith(".sh"));
+            if (impls.length === 1)
+                impl = impls[0].replace(/\.sh$/, "");
+        }
+    }
+    if (!impl) {
+        console.error(`could not auto-detect impl for ${cap}; pass --impl <name>`);
+        process.exit(1);
+    }
+    // Ensure .gg/eyes exists + shared is present
+    doInit();
+    const installArgs = [join(capDir, "install.sh"), impl];
+    if (asName)
+        installArgs.push("--as", asName);
+    const r = spawnSync("bash", installArgs, {
+        stdio: "inherit",
+        env: { ...process.env, EYES_PROJECT_ROOT: process.cwd() },
+    });
+    if (r.status !== 0) {
+        console.error(`install failed for ${cap}/${impl}`);
+        process.exit(r.status ?? 1);
+    }
+    // Record in manifest
+    const m = readManifest();
+    const name = asName ?? cap;
+    const script = `.gg/eyes/${name}.sh`;
+    const existing = m.probes.findIndex((p) => p.name === name);
+    const entry = { capability: cap, name, impl, script, status: "built" };
+    if (existing >= 0)
+        m.probes[existing] = entry;
+    else
+        m.probes.push(entry);
+    writeManifest(m);
+    console.log(`installed ${cap}/${impl} as ${script}`);
+}
+function doVerify(args) {
+    const target = args[0];
+    const m = readManifest();
+    const targets = target
+        ? m.probes.filter((p) => p.name === target)
+        : m.probes.filter((p) => p.status === "built");
+    if (!targets.length) {
+        console.log("no built probes to verify");
+        return;
+    }
+    for (const p of targets) {
+        const testPath = join(PROBES_DIR, p.capability, "test.sh");
+        if (!existsSync(testPath)) {
+            console.log(`- ${p.name}: no test.sh, skipping`);
+            continue;
+        }
+        const r = spawnSync("bash", [testPath, p.name], {
+            stdio: "inherit",
+            env: { ...process.env, EYES_PROJECT_ROOT: process.cwd() },
+        });
+        if (r.status === 0) {
+            p.status = "verified";
+            delete p.error;
+            console.log(`✓ ${p.name}`);
+        }
+        else {
+            p.status = "failed";
+            p.error = `test.sh exit ${r.status}`;
+            console.log(`✗ ${p.name} (exit ${r.status})`);
+        }
+    }
+    writeManifest(m);
+}
+function doList() {
+    const m = readManifest();
+    if (!m.probes.length) {
+        console.log("no probes installed. run: ggcoder-eyes detect | install <capability>");
+        return;
+    }
+    for (const p of m.probes) {
+        const flag = p.status === "verified" ? "✓" : p.status === "failed" ? "✗" : "·";
+        console.log(`${flag} ${p.name.padEnd(20)} ${p.capability.padEnd(18)} ${p.impl.padEnd(12)} ${p.status}${p.error ? ` (${p.error})` : ""}`);
+    }
+}
+const LOG_KINDS = new Set(["rough", "wish", "blocked"]);
+const LOG_STATUSES = new Set(["open", "deferred", "acked"]);
+function doLog(args) {
+    const sub = args[0];
+    if (!sub) {
+        console.error("usage: ggcoder-eyes log <rough|wish|blocked|ack|defer|list|count> ...");
+        process.exit(1);
+    }
+    // Gate: non-eyes projects get silent no-ops for all log subcommands.
+    // Reads return empty / zero; writes do nothing. Exit code is always 0 so
+    // callers (probes, hooks) can invoke freely without branching on setup state.
+    if (!isEyesActive(process.cwd())) {
+        if (sub === "list")
+            console.log("[]");
+        else if (sub === "count")
+            console.log("0");
+        return;
+    }
+    if (LOG_KINDS.has(sub)) {
+        const reason = args[1];
+        if (!reason) {
+            console.error(`usage: ggcoder-eyes log ${sub} "<reason>" [--probe <name>]`);
+            process.exit(1);
+        }
+        let probe;
+        for (let i = 2; i < args.length; i++) {
+            if (args[i] === "--probe")
+                probe = args[++i];
+        }
+        const entry = appendEntry({ kind: sub, reason, probe });
+        if (entry)
+            console.log(entry.id);
+        return;
+    }
+    if (sub === "ack" || sub === "defer") {
+        const id = args[1];
+        if (!id) {
+            console.error(`usage: ggcoder-eyes log ${sub} <id>`);
+            process.exit(1);
+        }
+        const ok = updateEntry(id, { status: sub === "ack" ? "acked" : "deferred" });
+        if (!ok) {
+            console.error(`no entry with id: ${id}`);
+            process.exit(1);
+        }
+        console.log(`${sub}: ${id}`);
+        return;
+    }
+    if (sub === "list" || sub === "count") {
+        let status;
+        let kind;
+        let limit;
+        for (let i = 1; i < args.length; i++) {
+            const flag = args[i];
+            const val = args[++i];
+            if (flag === "--status" && LOG_STATUSES.has(val))
+                status = val;
+            else if (flag === "--kind" && LOG_KINDS.has(val))
+                kind = val;
+            else if (flag === "--limit")
+                limit = Number(val);
+        }
+        if (sub === "count") {
+            console.log(String(journalCount({ status, kind })));
+        }
+        else {
+            const entries = readJournal({ status, kind, limit, order: "desc" });
+            console.log(JSON.stringify(entries, null, 2));
+        }
+        return;
+    }
+    console.error(`unknown log subcommand: ${sub}`);
+    process.exit(1);
+}
+const cmd = process.argv[2];
+const args = process.argv.slice(3);
+switch (cmd) {
+    case "init":
+        doInit();
+        break;
+    case "detect":
+        doDetect();
+        break;
+    case "install":
+        doInstall(args);
+        break;
+    case "verify":
+        doVerify(args);
+        break;
+    case "list":
+        doList();
+        break;
+    case "log":
+        doLog(args);
+        break;
+    default:
+        console.error(`usage: ggcoder-eyes <command>
+
+commands:
+  init                          create .gg/eyes/, copy shared infra, update .gitignore
+  detect                        emit JSON of capability → {candidates, primary}
+  install <cap> [--impl <name>] [--as <name>]
+                                install deps + copy probe into .gg/eyes/
+  verify [<name>]               run probe self-tests, update manifest
+  list                          show installed probes and their status
+  log <rough|wish|blocked> "<reason>" [--probe <name>]
+                                append a journal entry (silent no-op if eyes not set up)
+  log <ack|defer> <id>          change an entry's status
+  log list [--status S] [--kind K] [--limit N]
+                                emit JSON array of journal entries
+  log count [--status S] [--kind K]
+                                print count to stdout
+`.trim());
+        process.exit(cmd ? 1 : 0);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { isEyesActive, eyesRoot, manifestPath, journalPath, appendEntry, readJournal, journalCount, updateEntry, genId, } from "./journal.js";
+export type { JournalEntry, JournalKind, JournalStatus } from "./journal.js";
+export { readManifest } from "./manifest.js";
+export type { Manifest, ProbeEntry, ProbeStatus } from "./manifest.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,GACN,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { isEyesActive, eyesRoot, manifestPath, journalPath, appendEntry, readJournal, journalCount, updateEntry, genId, } from "./journal.js";
+export { readManifest } from "./manifest.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACX,KAAK,GACN,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/journal.d.ts

@@ -0,0 +1,40 @@
+export type JournalKind = "rough" | "wish" | "blocked";
+export type JournalStatus = "open" | "deferred" | "acked";
+export type JournalEntry = {
+    id: string;
+    ts: string;
+    kind: JournalKind;
+    reason: string;
+    probe?: string;
+    status: JournalStatus;
+};
+export declare function eyesRoot(cwd?: string): string;
+export declare function manifestPath(cwd?: string): string;
+export declare function journalPath(cwd?: string): string;
+/** Single gate for every eyes-related runtime behavior. If this returns false,
+ * the project has not been set up with `/eyes` and all integrations no-op. */
+export declare function isEyesActive(cwd?: string): boolean;
+export declare function genId(): string;
+type AppendInput = {
+    kind: JournalKind;
+    reason: string;
+    probe?: string;
+    status?: JournalStatus;
+};
+export declare function appendEntry(input: AppendInput, cwd?: string): JournalEntry | null;
+type ReadOptions = {
+    status?: JournalStatus;
+    kind?: JournalKind;
+    limit?: number;
+    order?: "asc" | "desc";
+};
+export declare function readJournal(options?: ReadOptions, cwd?: string): JournalEntry[];
+export declare function journalCount(options?: {
+    status?: JournalStatus;
+    kind?: JournalKind;
+}, cwd?: string): number;
+/** Rewrite-based update. Journal is expected to stay small (tens to low
+ * hundreds of entries); a full rewrite is fine. */
+export declare function updateEntry(id: string, patch: Partial<Pick<JournalEntry, "status" | "reason">>, cwd?: string): boolean;
+export {};
+//# sourceMappingURL=journal.d.ts.map

package/dist/journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE5D;AAED,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEhE;AAED,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAE/D;AAED;8EAC8E;AAC9E,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAEjE;AAED,wBAAgB,KAAK,IAAI,MAAM,CAM9B;AAED,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,GAAE,MAAsB,GAAG,YAAY,GAAG,IAAI,CAchG;AAED,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,WAAW,CACzB,OAAO,GAAE,WAAgB,EACzB,GAAG,GAAE,MAAsB,GAC1B,YAAY,EAAE,CAoBhB;AAED,wBAAgB,YAAY,CAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,aAAa,CAAC;IAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAAO,EAC5D,GAAG,GAAE,MAAsB,GAC1B,MAAM,CAER;AAED;mDACmD;AACnD,wBAAgB,WAAW,CACzB,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAC,EACvD,GAAG,GAAE,MAAsB,GAC1B,OAAO,CAuBT"}

package/dist/journal.js

@@ -0,0 +1,104 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { randomBytes } from "node:crypto";
+export function eyesRoot(cwd = process.cwd()) {
+    return resolve(cwd, ".gg/eyes");
+}
+export function manifestPath(cwd = process.cwd()) {
+    return resolve(eyesRoot(cwd), "manifest.json");
+}
+export function journalPath(cwd = process.cwd()) {
+    return resolve(eyesRoot(cwd), "journal.jsonl");
+}
+/** Single gate for every eyes-related runtime behavior. If this returns false,
+ * the project has not been set up with `/eyes` and all integrations no-op. */
+export function isEyesActive(cwd = process.cwd()) {
+    return existsSync(manifestPath(cwd));
+}
+export function genId() {
+    const ts = new Date()
+        .toISOString()
+        .replace(/[-:.TZ]/g, "")
+        .slice(0, 15);
+    return `${ts}-${randomBytes(2).toString("hex")}`;
+}
+export function appendEntry(input, cwd = process.cwd()) {
+    if (!isEyesActive(cwd))
+        return null;
+    const entry = {
+        id: genId(),
+        ts: new Date().toISOString(),
+        kind: input.kind,
+        reason: input.reason,
+        status: input.status ?? "open",
+        ...(input.probe ? { probe: input.probe } : {}),
+    };
+    const p = journalPath(cwd);
+    mkdirSync(dirname(p), { recursive: true });
+    appendFileSync(p, JSON.stringify(entry) + "\n");
+    return entry;
+}
+export function readJournal(options = {}, cwd = process.cwd()) {
+    if (!isEyesActive(cwd))
+        return [];
+    const p = journalPath(cwd);
+    if (!existsSync(p))
+        return [];
+    const text = readFileSync(p, "utf8");
+    let entries = [];
+    for (const line of text.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            entries.push(JSON.parse(trimmed));
+        }
+        catch {
+            // skip malformed — logs are append-only, don't die on one bad line
+        }
+    }
+    if (options.status)
+        entries = entries.filter((e) => e.status === options.status);
+    if (options.kind)
+        entries = entries.filter((e) => e.kind === options.kind);
+    if (options.order === "desc")
+        entries.reverse();
+    if (typeof options.limit === "number")
+        entries = entries.slice(0, options.limit);
+    return entries;
+}
+export function journalCount(options = {}, cwd = process.cwd()) {
+    return readJournal(options, cwd).length;
+}
+/** Rewrite-based update. Journal is expected to stay small (tens to low
+ * hundreds of entries); a full rewrite is fine. */
+export function updateEntry(id, patch, cwd = process.cwd()) {
+    if (!isEyesActive(cwd))
+        return false;
+    const p = journalPath(cwd);
+    if (!existsSync(p))
+        return false;
+    const lines = readFileSync(p, "utf8").split("\n");
+    let found = false;
+    const next = lines.map((line) => {
+        const trimmed = line.trim();
+        if (!trimmed)
+            return line;
+        try {
+            const entry = JSON.parse(trimmed);
+            if (entry.id === id) {
+                found = true;
+                return JSON.stringify({ ...entry, ...patch });
+            }
+            return line;
+        }
+        catch {
+            return line;
+        }
+    });
+    if (!found)
+        return false;
+    writeFileSync(p, next.join("\n"));
+    return true;
+}
+//# sourceMappingURL=journal.js.map

package/dist/journal.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,16 @@
+export type ProbeStatus = "pending" | "built" | "verified" | "failed";
+export type ProbeEntry = {
+    capability: string;
+    name: string;
+    impl: string;
+    script: string;
+    status: ProbeStatus;
+    error?: string;
+};
+export type Manifest = {
+    version: 1;
+    phase_completed?: "research" | "design" | "build" | "verify" | "document";
+    probes: ProbeEntry[];
+};
+export declare function readManifest(cwd?: string): Manifest;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEtE,MAAM,MAAM,UAAU,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,EAAE,CAAC,CAAC;IACX,eAAe,CAAC,EAAE,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC1E,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB,CAAC;AAIF,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,QAAQ,CASlE"}

package/dist/manifest.js

@@ -0,0 +1,17 @@
+import { existsSync, readFileSync } from "node:fs";
+import { isEyesActive, manifestPath } from "./journal.js";
+const EMPTY = { version: 1, probes: [] };
+export function readManifest(cwd = process.cwd()) {
+    if (!isEyesActive(cwd))
+        return EMPTY;
+    const p = manifestPath(cwd);
+    if (!existsSync(p))
+        return EMPTY;
+    try {
+        return JSON.parse(readFileSync(p, "utf8"));
+    }
+    catch {
+        return EMPTY;
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAmB1D,MAAM,KAAK,GAAa,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAEnD,MAAM,UAAU,YAAY,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACtD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,MAAM,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAa,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@kenkaiiii/ggcoder-eyes",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Project-agnostic perception probes for coding agents — screenshots, logs, APIs, capture sinks",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kenkaiiii/gg-framework.git",
+    "directory": "packages/ggcoder-eyes"
+  },
+  "bin": {
+    "ggcoder-eyes": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./cli": "./dist/cli.js",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "probes",
+    "shared"
+  ],
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc && chmod +x dist/cli.js || true",
+    "check": "tsc --noEmit"
+  }
+}