@hcgstudio/ogma 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 HCG Studio
+
+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/README.md

@@ -0,0 +1,39 @@
+# @hcgstudio/ogma
+
+Local-first design review for AI-generated React JSX prototypes.
+
+```bash
+npm install -D @hcgstudio/ogma
+npx ogma scaffold
+npx ogma start
+```
+
+Ogma creates `designs/ogma/review.tsx`, `designs/ogma/product-notes.md`, and `.ogma/session.json` when they do not exist. `scaffold` prepares those files without launching a server; `start` also creates missing files before opening `http://localhost:4317/review`.
+
+## Agent Skill URL
+
+Give this URL to Codex, Claude Code, or another coding agent:
+
+```text
+https://raw.githubusercontent.com/hcgstudio/ogma/main/docs/skills/ogma/SKILL.md
+```
+
+Install: Copy the following to your code agent:
+
+```text
+Read: https://raw.githubusercontent.com/hcgstudio/ogma/main/docs/skills/ogma/SKILL.md
+```
+
+The skill tells agents how to write JSX screens, update product notes, install Ogma, start the local server, and preserve feedback IDs such as `OG-001`.
+
+## Commands
+
+```bash
+npx ogma scaffold
+npx ogma scaffold --review designs/ogma
+npx ogma init
+npx ogma start --review designs/ogma
+npx ogma skill-url
+```
+
+Feedback is stored locally in `.ogma/session.json`, exported for agents from `/api/ogma/feedback`, imported with `PUT /api/ogma/feedback`, tracked in `.ogma/history.json`, and snapshotted in `.ogma/snapshots`.

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,155 @@
+#!/usr/bin/env node
+import path from 'node:path';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import { DEFAULT_DESIGN_DIR, DEFAULT_SKILL_URL } from './node/templates.js';
+function parseArgs(argv) {
+    const args = [...argv];
+    const command = args[0] && !args[0].startsWith('-') ? args.shift() ?? 'start' : 'start';
+    const flags = new Map();
+    for (let index = 0; index < args.length; index += 1) {
+        const item = args[index];
+        if (!item?.startsWith('--')) {
+            continue;
+        }
+        const [rawName, rawValue] = item.slice(2).split('=', 2);
+        const name = rawName ?? '';
+        if (name.startsWith('no-')) {
+            flags.set(name.slice(3), false);
+            continue;
+        }
+        if (rawValue !== undefined) {
+            flags.set(name, rawValue);
+            continue;
+        }
+        const next = args[index + 1];
+        if (next && !next.startsWith('--')) {
+            flags.set(name, next);
+            index += 1;
+        }
+        else {
+            flags.set(name, true);
+        }
+    }
+    return { command, flags };
+}
+function stringFlag(flags, name, fallback) {
+    const value = flags.get(name);
+    return typeof value === 'string' ? value : fallback;
+}
+function numberFlag(flags, name, fallback) {
+    const value = Number(stringFlag(flags, name, String(fallback)));
+    return Number.isFinite(value) ? value : fallback;
+}
+function booleanFlag(flags, name, fallback) {
+    const value = flags.get(name);
+    return typeof value === 'boolean' ? value : fallback;
+}
+function displayPath(cwd, targetPath) {
+    const relativePath = path.relative(cwd, targetPath);
+    return relativePath && !relativePath.startsWith('..') && !path.isAbsolute(relativePath)
+        ? relativePath
+        : targetPath;
+}
+function printScaffoldResult(project) {
+    console.log('Ogma scaffold ready');
+    if (project.createdPaths.length > 0) {
+        console.log('  Created:');
+        for (const createdPath of project.createdPaths) {
+            console.log(`    - ${displayPath(project.cwd, createdPath)}`);
+        }
+    }
+    else {
+        console.log('  Created: none');
+    }
+    console.log(`  Designs:  ${displayPath(project.cwd, project.designEntry)}`);
+    console.log(`  Notes:    ${displayPath(project.cwd, project.notesPath)}`);
+    console.log(`  Feedback: ${displayPath(project.cwd, project.sessionPath)}`);
+}
+function printHelp() {
+    console.log(`Ogma local design review
+
+Usage:
+  ogma scaffold [--review designs/ogma]
+  ogma start [--review designs/ogma] [--port 4317] [--host localhost] [--no-open]
+  ogma init [--review designs/ogma]
+  ogma skill-url
+
+Commands:
+  scaffold  Create the JSX review scaffold and local Ogma data files.
+  start      Create missing design files and launch the local review server.
+  init       Alias for scaffold.
+  skill-url  Print the public Ogma skill URL.
+
+Options:
+  --review <path>     Design directory or review entry file. Default: ${DEFAULT_DESIGN_DIR}
+  --port <number>     Preferred local port. Default: 4317
+  --host <host>       Host for the local server. Default: localhost
+  --skill-url <url>   Override the URL shown to agents.
+  --open / --no-open  Open the browser after startup. Default: --open
+`);
+}
+async function checkRuntimeDependencies() {
+    const major = Number(process.versions.node.split('.')[0] ?? '0');
+    if (major < 18) {
+        throw new Error('Ogma requires Node.js 18 or newer.');
+    }
+    const require = createRequire(path.join(packageRoot(), 'package.json'));
+    const missing = [];
+    for (const specifier of ['react', 'react-dom/client', 'vite']) {
+        try {
+            require.resolve(specifier);
+        }
+        catch {
+            missing.push(specifier);
+        }
+    }
+    if (missing.length > 0) {
+        throw new Error(`Missing runtime dependencies: ${missing.join(', ')}. Run npm install -D @hcgstudio/ogma react react-dom vite.`);
+    }
+}
+function packageRoot() {
+    return path.dirname(path.dirname(fileURLToPath(import.meta.url)));
+}
+async function main() {
+    const { command, flags } = parseArgs(process.argv.slice(2));
+    if (flags.has('help') || command === 'help') {
+        printHelp();
+        return;
+    }
+    if (command === 'skill-url') {
+        console.log(stringFlag(flags, 'skill-url', DEFAULT_SKILL_URL));
+        return;
+    }
+    await checkRuntimeDependencies();
+    const cwd = process.cwd();
+    const review = stringFlag(flags, 'review');
+    if (command === 'init' || command === 'scaffold') {
+        const { ensureOgmaProject } = await import('./node/project.js');
+        const project = await ensureOgmaProject({ cwd, review });
+        printScaffoldResult(project);
+        return;
+    }
+    if (command !== 'start') {
+        printHelp();
+        process.exitCode = 1;
+        return;
+    }
+    const { startOgmaServer } = await import('./node/server.js');
+    await startOgmaServer({
+        cwd,
+        host: stringFlag(flags, 'host', 'localhost') ?? 'localhost',
+        open: booleanFlag(flags, 'open', true),
+        packageRoot: packageRoot(),
+        port: numberFlag(flags, 'port', 4317),
+        review,
+        skillUrl: stringFlag(flags, 'skill-url', DEFAULT_SKILL_URL)
+    });
+}
+main().catch((error) => {
+    console.error('');
+    console.error(`[ogma] ${error instanceof Error ? error.message : String(error)}`);
+    console.error('');
+    process.exitCode = 1;
+});
+//# 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/defineOgmaReview.d.ts

@@ -0,0 +1,3 @@
+import type { OgmaReviewDefinition } from './types.js';
+export declare function defineOgmaReview(review: OgmaReviewDefinition): OgmaReviewDefinition;
+//# sourceMappingURL=defineOgmaReview.d.ts.map

package/dist/defineOgmaReview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineOgmaReview.d.ts","sourceRoot":"","sources":["../src/defineOgmaReview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,CAEnF"}

package/dist/defineOgmaReview.js

@@ -0,0 +1,4 @@
+export function defineOgmaReview(review) {
+    return review;
+}
+//# sourceMappingURL=defineOgmaReview.js.map

package/dist/defineOgmaReview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineOgmaReview.js","sourceRoot":"","sources":["../src/defineOgmaReview.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,gBAAgB,CAAC,MAA4B;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { defineOgmaReview } from './defineOgmaReview.js';
+export { OgmaReviewApp } from './viewer/OgmaReviewApp.js';
+export { createDefaultOgmaReview } from './viewer/defaultReview.js';
+export type { OgmaAnnotation, OgmaAnnotationStatus, OgmaClientConfig, OgmaFeedbackExport, OgmaPrototypeScreen, OgmaPrototypeScreenProps, OgmaReviewDefinition, OgmaReviewMetadata, OgmaReviewSession, OgmaServerStatus, OgmaSessionHistoryEntry, OgmaViewportSnapshot } from './types.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,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { defineOgmaReview } from './defineOgmaReview.js';
+export { OgmaReviewApp } from './viewer/OgmaReviewApp.js';
+export { createDefaultOgmaReview } from './viewer/defaultReview.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,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/node/project.d.ts

@@ -0,0 +1,18 @@
+export interface OgmaResolvedProject {
+    cwd: string;
+    createdPaths: string[];
+    dataDir: string;
+    defaultDesignDir: string;
+    designEntry: string;
+    existingPaths: string[];
+    feedbackPath: string;
+    historyPath: string;
+    notesPath: string;
+    sessionPath: string;
+    snapshotsDir: string;
+}
+export declare function ensureOgmaProject({ cwd, review }: {
+    cwd: string;
+    review?: string;
+}): Promise<OgmaResolvedProject>;
+//# sourceMappingURL=project.d.ts.map

package/dist/node/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/node/project.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAqFD,wBAAsB,iBAAiB,CAAC,EACtC,GAAG,EACH,MAAM,EACP,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkC/B"}

package/dist/node/project.js

@@ -0,0 +1,104 @@
+import { mkdir, stat, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_DESIGN_DIR, DEFAULT_PRODUCT_NOTES, DEFAULT_REVIEW_SOURCE } from './templates.js';
+const reviewEntryNames = ['review.tsx', 'review.jsx', 'ogma.review.tsx', 'ogma.review.jsx'];
+function nowIso() {
+    return new Date().toISOString();
+}
+function emptySession() {
+    return {
+        reviewId: 'ogma-review',
+        annotations: [],
+        updatedAt: nowIso()
+    };
+}
+async function fileExists(filePath) {
+    try {
+        await stat(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function pathIsFile(filePath) {
+    try {
+        return (await stat(filePath)).isFile();
+    }
+    catch {
+        return Boolean(path.extname(filePath));
+    }
+}
+async function ensureDirectory(dirPath, project) {
+    if (await fileExists(dirPath)) {
+        await mkdir(dirPath, { recursive: true });
+        project.existingPaths.push(dirPath);
+        return;
+    }
+    await mkdir(dirPath, { recursive: true });
+    project.createdPaths.push(dirPath);
+}
+async function ensureFile(filePath, contents, project) {
+    if (await fileExists(filePath)) {
+        project.existingPaths.push(filePath);
+        return;
+    }
+    await writeFile(filePath, contents, 'utf8');
+    project.createdPaths.push(filePath);
+}
+async function resolveReviewTarget(cwd, target = DEFAULT_DESIGN_DIR) {
+    const absoluteTarget = path.resolve(cwd, target);
+    if (await pathIsFile(absoluteTarget)) {
+        return {
+            designDir: path.dirname(absoluteTarget),
+            designEntry: absoluteTarget
+        };
+    }
+    for (const entryName of reviewEntryNames) {
+        const candidate = path.join(absoluteTarget, entryName);
+        if (await fileExists(candidate)) {
+            return {
+                designDir: absoluteTarget,
+                designEntry: candidate
+            };
+        }
+    }
+    return {
+        designDir: absoluteTarget,
+        designEntry: path.join(absoluteTarget, reviewEntryNames[0] ?? 'review.tsx')
+    };
+}
+export async function ensureOgmaProject({ cwd, review }) {
+    const { designDir, designEntry } = await resolveReviewTarget(cwd, review);
+    const dataDir = path.join(cwd, '.ogma');
+    const notesPath = path.join(designDir, 'product-notes.md');
+    const sessionPath = path.join(dataDir, 'session.json');
+    const feedbackPath = path.join(dataDir, 'feedback.json');
+    const historyPath = path.join(dataDir, 'history.json');
+    const snapshotsDir = path.join(dataDir, 'snapshots');
+    const project = {
+        createdPaths: [],
+        existingPaths: []
+    };
+    await ensureDirectory(designDir, project);
+    await ensureDirectory(dataDir, project);
+    await ensureDirectory(snapshotsDir, project);
+    await ensureFile(designEntry, DEFAULT_REVIEW_SOURCE, project);
+    await ensureFile(notesPath, DEFAULT_PRODUCT_NOTES, project);
+    await ensureFile(sessionPath, `${JSON.stringify(emptySession(), null, 2)}\n`, project);
+    await ensureFile(historyPath, '[]\n', project);
+    return {
+        cwd,
+        createdPaths: project.createdPaths,
+        dataDir,
+        defaultDesignDir: path.relative(cwd, designDir) || '.',
+        designEntry,
+        existingPaths: project.existingPaths,
+        feedbackPath,
+        historyPath,
+        notesPath,
+        sessionPath,
+        snapshotsDir
+    };
+}
+//# sourceMappingURL=project.js.map

package/dist/node/project.js.map

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

package/dist/node/server.d.ts

@@ -0,0 +1,21 @@
+import { type ViteDevServer } from 'vite';
+import type { OgmaServerStatus } from '../types.js';
+import { type OgmaResolvedProject } from './project.js';
+export interface OgmaStartOptions {
+    cwd: string;
+    host: string;
+    open: boolean;
+    packageRoot: string;
+    port: number;
+    review?: string;
+    skillUrl?: string;
+}
+export declare function getPackageRootFromImportMeta(metaUrl: string): string;
+export declare function startOgmaServer(options: OgmaStartOptions): Promise<{
+    project: OgmaResolvedProject;
+    reviewUrl: string;
+    server: ViteDevServer;
+    status: OgmaServerStatus;
+}>;
+export declare function assertPackageInstalledFromCwd(cwd: string): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/node/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/node/server.ts"],"names":[],"mappings":"AAMA,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,MAAM,CAAC;AACrE,OAAO,KAAK,EAMV,gBAAgB,EAGjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAqB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAK3E,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmbD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,MAAM,UAE3D;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB;;;;;GA6G9D;AAED,wBAAsB,6BAA6B,CAAC,GAAG,EAAE,MAAM,iBAiB9D"}