youmd 0.11.0 → 0.13.0

package/dist/lib/brain/vision.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJECT_VISION_INDEX_VERSION = void 0;
+exports.projectVisionIndexFromSnapshot = projectVisionIndexFromSnapshot;
+exports.PROJECT_VISION_INDEX_VERSION = "you-md/project-vision-index/v1";
+const PROJECT_VISION_DIRECTORIES = new Set(["reviews", "artifacts"]);
+function stemFor(file) { return file.replace(/\.[^.]+$/, "").split("/").pop() || file; }
+function formatFor(file) {
+    if (/\.html?$/i.test(file))
+        return "html";
+    if (/\.md$/i.test(file))
+        return "markdown";
+    if (/\.json$/i.test(file))
+        return "json";
+    return null;
+}
+function metadata(stem) {
+    const normalized = stem.toLowerCase();
+    const date = normalized.match(/(?:^|[^0-9])((?:20)\d{2}-\d{2}-\d{2})(?:$|[^0-9])/)?.[1] || null;
+    const horizon = /(?:year|annual)/.test(normalized) ? "year"
+        : /quarter|\bq[1-4]\b/.test(normalized) ? "quarter"
+            : /month|monthly/.test(normalized) ? "month"
+                : /week|weekly/.test(normalized) ? "week" : null;
+    const family = /north[-_ ]?star/.test(normalized) ? "north-star"
+        : /vision/.test(normalized) ? "vision"
+            : /strategy|positioning/.test(normalized) ? "strategy" : "planning";
+    const classifiedFamily = /audit|report/.test(normalized) ? "audit"
+        : /brain/.test(normalized) ? "project-brain" : family;
+    return { title: stem.replace(/[-_]+/g, " "), date, horizon, family: classifiedFamily };
+}
+function eligible(artifact, contextRoot) {
+    if (!/(?:vision|north[-_ ]?star|brain|strategy|positioning|roadmap|plan|audit|report|brief|annual|quarterly|monthly|weekly)/i.test(stemFor(artifact.path)))
+        return false;
+    const normalized = artifact.path.toLowerCase().replace(/^\.\//, "");
+    const root = contextRoot.toLowerCase().replace(/^\.\//, "");
+    if (!normalized.startsWith(`${root}/`))
+        return false;
+    const within = normalized.slice(root.length + 1).split("/");
+    return within.length === 1 || (within.length === 2 && PROJECT_VISION_DIRECTORIES.has(within[0]));
+}
+/** Pure, path-only projection. It never reads artifact bodies or invents content. */
+function projectVisionIndexFromSnapshot(snapshot, readiness, revision) {
+    const artifacts = new Map();
+    for (const project of snapshot?.projects || []) {
+        for (const artifact of project.artifacts.filter((candidate) => eligible(candidate, project.contextRoot))) {
+            const stem = stemFor(artifact.path);
+            const key = `${project.projectRef}\0${stem}`;
+            const current = artifacts.get(key) || {
+                artifactRef: artifact.artifactRef, projectRef: project.projectRef, stem, ...metadata(stem),
+                formats: { html: null, markdown: null, json: null }, provenance: artifact.provenance,
+            };
+            const format = formatFor(artifact.path);
+            if (format && current.formats[format] === null)
+                current.formats[format] = artifact.path;
+            artifacts.set(key, current);
+        }
+    }
+    return {
+        schemaVersion: exports.PROJECT_VISION_INDEX_VERSION, kind: "project-vision-index",
+        projectRef: snapshot?.projects[0]?.projectRef || null, workspaceRef: snapshot?.workspaceRef || null,
+        revision: revision || snapshot?.revision.digest || null, readiness,
+        artifacts: [...artifacts.values()].sort((a, b) => a.projectRef.localeCompare(b.projectRef) || a.stem.localeCompare(b.stem)),
+    };
+}
+//# sourceMappingURL=vision.js.map

package/dist/lib/brain/vision.js.map

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

package/dist/lib/businessScaffold.d.ts

@@ -0,0 +1,42 @@
+export declare const BUSINESS_MD_FILENAME = "BUSINESS.md";
+export declare const MANAGED_BLOCK_START = "<!-- you.md:business:managed:start -->";
+export declare const MANAGED_BLOCK_END = "<!-- you.md:business:managed:end -->";
+export interface BusinessScaffoldProject {
+    slug: string;
+    name?: string | null;
+    weeklyFocus?: string | null;
+    weeklyIntent?: string | null;
+    repoFullName?: string | null;
+}
+export interface BusinessScaffoldInput {
+    slug: string;
+    name: string;
+    tagline?: string | null;
+    stage?: string | null;
+    mission?: string | null;
+    revenueLine?: string | null;
+    projects?: BusinessScaffoldProject[];
+    ungroupedNote?: string | null;
+}
+/**
+ * Render the managed block deterministically: same input, same bytes. No
+ * timestamps — churn-free re-runs let the daemon regenerate on every sync
+ * without dirtying repositories that have not actually changed.
+ */
+export declare function renderBusinessManagedBlock(input: BusinessScaffoldInput): string;
+/**
+ * Merge the managed block into existing file content. A file without markers
+ * keeps ALL of its current content below the new block (never destroys
+ * hand-written context); a file with markers gets only the block replaced.
+ */
+export declare function mergeBusinessMd(existing: string | null, managedBlock: string): string;
+export interface ScaffoldWriteResult {
+    filePath: string;
+    action: "created" | "updated" | "unchanged";
+}
+/**
+ * Write (or refresh) BUSINESS.md at the given repo root. Returns what actually
+ * happened so callers can report honestly and daemons can skip no-op commits.
+ */
+export declare function writeBusinessMd(repoRoot: string, input: BusinessScaffoldInput): ScaffoldWriteResult;
+//# sourceMappingURL=businessScaffold.d.ts.map

package/dist/lib/businessScaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"businessScaffold.d.ts","sourceRoot":"","sources":["../../src/lib/businessScaffold.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,mBAAmB,2CAA2C,CAAC;AAC5E,eAAO,MAAM,iBAAiB,yCAAyC,CAAC;AAExE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACrC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAiBD;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CA2C/E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAarF;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,qBAAqB,GAC3B,mBAAmB,CAUrB"}

package/dist/lib/businessScaffold.js

@@ -0,0 +1,150 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MANAGED_BLOCK_END = exports.MANAGED_BLOCK_START = exports.BUSINESS_MD_FILENAME = void 0;
+exports.renderBusinessManagedBlock = renderBusinessManagedBlock;
+exports.mergeBusinessMd = mergeBusinessMd;
+exports.writeBusinessMd = writeBusinessMd;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Business root context scaffold (request 176): every business gets its own
+// you.md-style context file at the root of its root repo, so any agent opening
+// that repo starts warm on the BUSINESS (not just the repo). The file has a
+// managed block regenerated from hosted Founder OS data; everything below the
+// end marker is owner territory and survives every re-run.
+exports.BUSINESS_MD_FILENAME = "BUSINESS.md";
+exports.MANAGED_BLOCK_START = "<!-- you.md:business:managed:start -->";
+exports.MANAGED_BLOCK_END = "<!-- you.md:business:managed:end -->";
+const STAGE_LABELS = {
+    idea: "idea",
+    building: "building",
+    free_beta: "free beta",
+    paid_beta: "paid beta",
+    launched: "launched",
+    paused: "paused",
+};
+function clean(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const cleaned = value.replace(/\s+/g, " ").trim();
+    return cleaned || undefined;
+}
+/**
+ * Render the managed block deterministically: same input, same bytes. No
+ * timestamps — churn-free re-runs let the daemon regenerate on every sync
+ * without dirtying repositories that have not actually changed.
+ */
+function renderBusinessManagedBlock(input) {
+    const lines = [];
+    lines.push(exports.MANAGED_BLOCK_START);
+    lines.push(`# ${clean(input.name) ?? input.slug}`);
+    lines.push("");
+    const tagline = clean(input.tagline);
+    if (tagline) {
+        lines.push(tagline);
+        lines.push("");
+    }
+    const stage = clean(input.stage)?.toLowerCase();
+    lines.push(`- **Business:** \`${input.slug}\` (you.md Founder OS)`);
+    if (stage)
+        lines.push(`- **Stage:** ${STAGE_LABELS[stage] ?? stage}`);
+    const revenue = clean(input.revenueLine);
+    if (revenue)
+        lines.push(`- **Revenue:** ${revenue}`);
+    const mission = clean(input.mission);
+    if (mission)
+        lines.push(`- **Mission:** ${mission}`);
+    lines.push("");
+    const projects = (input.projects ?? []).filter((project) => clean(project.slug));
+    if (projects.length > 0) {
+        lines.push("## Projects");
+        lines.push("");
+        for (const project of projects) {
+            const label = clean(project.name) ?? project.slug;
+            const repo = clean(project.repoFullName);
+            const focus = project.weeklyFocus === "focus"
+                ? clean(project.weeklyIntent)
+                    ? ` — this week: ${clean(project.weeklyIntent)}`
+                    : " — this week: focus"
+                : "";
+            lines.push(`- \`${project.slug}\`${label !== project.slug ? ` (${label})` : ""}${repo ? ` — ${repo}` : ""}${focus}`);
+        }
+        lines.push("");
+    }
+    const note = clean(input.ungroupedNote);
+    if (note) {
+        lines.push(`> ${note}`);
+        lines.push("");
+    }
+    lines.push("Managed by you.md — everything above this marker is regenerated from the");
+    lines.push("Founder OS; add anything you like below it and it will be preserved.");
+    lines.push(exports.MANAGED_BLOCK_END);
+    return lines.join("\n");
+}
+/**
+ * Merge the managed block into existing file content. A file without markers
+ * keeps ALL of its current content below the new block (never destroys
+ * hand-written context); a file with markers gets only the block replaced.
+ */
+function mergeBusinessMd(existing, managedBlock) {
+    if (!existing || !existing.trim()) {
+        return managedBlock + "\n";
+    }
+    const startIdx = existing.indexOf(exports.MANAGED_BLOCK_START);
+    const endIdx = existing.indexOf(exports.MANAGED_BLOCK_END);
+    if (startIdx >= 0 && endIdx > startIdx) {
+        const before = existing.slice(0, startIdx);
+        const after = existing.slice(endIdx + exports.MANAGED_BLOCK_END.length);
+        return before + managedBlock + after;
+    }
+    // Existing content without markers: keep it, prepend the managed block.
+    return managedBlock + "\n\n" + existing.replace(/^\n+/, "");
+}
+/**
+ * Write (or refresh) BUSINESS.md at the given repo root. Returns what actually
+ * happened so callers can report honestly and daemons can skip no-op commits.
+ */
+function writeBusinessMd(repoRoot, input) {
+    const filePath = path.join(repoRoot, exports.BUSINESS_MD_FILENAME);
+    const managedBlock = renderBusinessManagedBlock(input);
+    const existing = fs.existsSync(filePath) ? fs.readFileSync(filePath, "utf8") : null;
+    const next = mergeBusinessMd(existing, managedBlock);
+    if (existing !== null && existing === next) {
+        return { filePath, action: "unchanged" };
+    }
+    fs.writeFileSync(filePath, next);
+    return { filePath, action: existing === null ? "created" : "updated" };
+}
+//# sourceMappingURL=businessScaffold.js.map

package/dist/lib/businessScaffold.js.map

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

package/dist/lib/codex-device-auth.d.ts

@@ -0,0 +1,94 @@
+import { type ChildProcess } from "child_process";
+import * as fs from "fs";
+/**
+ * The ChatGPT desktop bundle supplies the supported local Codex executable on
+ * this macOS adapter surface. This M3 adapter accepts only the exact sealed
+ * macOS bundle; it intentionally does not use PATH/npm/Homebrew candidates.
+ */
+export declare const CODEX_EXECUTABLE = "/Applications/ChatGPT.app/Contents/Resources/codex";
+export declare const CODEX_STATUS_ARGS: readonly ["login", "status"];
+export declare const CODEX_DEVICE_AUTH_ARGS: readonly ["login", "--device-auth"];
+export declare const CODEX_STATUS_MAX_OUTPUT_BYTES = 1024;
+export declare const CODEX_STATUS_TIMEOUT_MS = 5000;
+/** OpenAI's device flow has a long human approval window; leave margin. */
+export declare const CODEX_LOGIN_TIMEOUT_MS: number;
+export declare const CODEX_LOGIN_KILL_GRACE_MS = 3000;
+export type CodexAuthenticationKind = "chatgpt" | "api_key" | "signed_out" | "unknown" | "unavailable";
+export type CodexStatusReport = {
+    schemaVersion: "you-md/openai-codex-local-status/v1";
+    target: "openai_codex";
+    source: "codex_login_status";
+    authenticationKind: CodexAuthenticationKind;
+    authenticated: boolean;
+    providerCredentialsRead: false;
+    deviceCodeCaptured: false;
+};
+export type CodexStatusRunRequest = {
+    executable: string;
+    argv: readonly ["login", "status"];
+    shell: false;
+    stdio: ["ignore", "pipe", "pipe"];
+    timeoutMs: number;
+};
+export type CodexLoginRunRequest = {
+    executable: string;
+    argv: readonly ["login", "--device-auth"];
+    shell: false;
+    /** Interactive provider UI/code stay on the user's terminal only. */
+    stdio: "inherit";
+    timeoutMs: number;
+};
+/** Bounded status streams; raw contents are classified then immediately discarded. */
+export type CodexStatusRunResult = {
+    exitCode: number | null;
+    stdout: Buffer;
+    stderr?: Buffer;
+    timedOut?: boolean;
+};
+export type CodexLoginRunResult = {
+    exitCode: number | null;
+    cancelled?: boolean;
+    timedOut?: boolean;
+};
+export type CodexDeviceAuthDeps = {
+    runStatus?: (request: CodexStatusRunRequest) => Promise<CodexStatusRunResult>;
+    runLogin?: (request: CodexLoginRunRequest) => Promise<CodexLoginRunResult>;
+    /** Test-only resolver seam; there is no CLI/config executable override. */
+    resolveExecutable?: () => string | null;
+};
+export type CodexExecutableResolutionDeps = {
+    realpathSync?: typeof fs.realpathSync;
+    lstatSync?: typeof fs.lstatSync;
+    validateBundle?: (bundlePath: string) => boolean;
+};
+/** Validate code signature and designated OpenAI app identity; never CDHash-pin. */
+export declare function validateOfficialChatGPTBundle(bundlePath?: string): boolean;
+/**
+ * Resolve only the exact sealed ChatGPT bundle resource after validating the
+ * app's Apple/OpenAI designated requirement. No PATH, alias, config value, or
+ * caller-selected executable is part of this auth boundary.
+ */
+export declare function resolveTrustedCodexExecutable(deps?: CodexExecutableResolutionDeps): string | null;
+/**
+ * Intentionally exact matching. Never relay status output: if a future CLI
+ * prints a device URL, token, path, or arbitrary diagnostic, it becomes the
+ * safe `unknown` enum rather than data that You.md retains or uploads.
+ */
+export declare function classifyCodexLoginStatusStreams(stdout: Buffer, stderr: Buffer, exitCode: number | null): CodexStatusReport;
+/** Capture bounded status streams, classify them, then discard their raw bytes. */
+export declare function runCodexLoginStatus(request: CodexStatusRunRequest): Promise<CodexStatusRunResult>;
+/**
+ * Start an official interactive device-login flow without intercepting either
+ * stdout or stderr. The device code and callback URL never enter this process.
+ */
+/** Send TERM first and force KILL only if a local child resists. */
+export declare function terminateCodexChild(child: Pick<ChildProcess, "kill">, complete: () => void, graceMs?: number): NodeJS.Timeout;
+export declare function runCodexDeviceAuth(request: CodexLoginRunRequest): Promise<CodexLoginRunResult>;
+export declare function getCodexAuthenticationStatus(deps?: CodexDeviceAuthDeps): Promise<CodexStatusReport>;
+export type CodexLoginOutcome = {
+    status: CodexStatusReport;
+    loginChildRan: boolean;
+    providerStateChanged: boolean;
+};
+export declare function ensureCodexAuthentication(deps?: CodexDeviceAuthDeps): Promise<CodexLoginOutcome>;
+//# sourceMappingURL=codex-device-auth.d.ts.map

package/dist/lib/codex-device-auth.d.ts.map

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