@parlor/scaffold 0.0.0-stage → 0.1.0

package/dist/docs.d.ts

@@ -0,0 +1,12 @@
+import type { AppIdentity } from "./identity.js";
+import { type PackageManager } from "./package-manager.js";
+export interface ProjectDocsInput {
+    readonly identity: AppIdentity;
+    readonly packageManager: PackageManager;
+    readonly version: string;
+}
+/** Rendered per package manager, so every command in it runs as written. */
+export declare function renderReadme({ identity, packageManager }: ProjectDocsInput): string;
+/** Facts a coding agent cannot infer from the files, plus where the full docs are. */
+export declare function renderAgentsMd({ packageManager, version }: ProjectDocsInput): string;
+//# sourceMappingURL=docs.d.ts.map

package/dist/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAe,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGxE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAmCnF;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE,gBAAgB,GAAG,MAAM,CAwBpF"}

package/dist/docs.js

@@ -0,0 +1,66 @@
+import { commandsFor } from "./package-manager.js";
+import { DOCS_URL } from "./version.js";
+/** Rendered per package manager, so every command in it runs as written. */
+export function renderReadme({ identity, packageManager }) {
+    const pm = commandsFor(packageManager);
+    return `# ${identity.appName}
+
+A [Parlor](${DOCS_URL}) app. Everything the UI does goes through actions, so your coding agent
+can do it too: from the sidebar, over MCP, or over HTTP.
+
+## Develop
+
+\`\`\`sh
+${pm.run("dev")}
+\`\`\`
+
+Open http://localhost:5173 and press **Agent** to chat with the coding agent on this computer
+(Claude Code or Codex). Ask it to add a todo.
+
+| Command | What it does |
+| --- | --- |
+| \`${pm.run("dev")}\` | App, API and agent host with hot reload |
+| \`${pm.run("typecheck")}\` | Regenerate the route tree, then \`tsc\` |
+| \`${pm.run("test")}\` | Vitest |
+| \`${pm.run("db:generate")}\` | A SQL migration from \`schema/\` |
+| \`${pm.run("build")}\` | Production build in \`.parlor/\` |
+| \`${pm.exec("parlor", ["add", "auth"])}\` | Sign-in, so each user sees only their own data |
+| \`${pm.exec("parlor", ["dev", "--target", "mac"])}\` | The same app as a macOS window |
+
+## Layout
+
+- \`actions/\`: every piece of business logic, as \`defineAction\`. The UI, agents, HTTP and MCP all call these.
+- \`schema/\`: the Drizzle tables; \`migrations/\` is generated from them.
+- \`src/routes/\`: pages. \`src/agent/\`: the agent sidebar, yours to change.
+- \`parlor.config.ts\`: app name, id, ports, and Vite options under \`vite\`.
+
+Learn more at ${DOCS_URL}/getting-started/.
+`;
+}
+/** Facts a coding agent cannot infer from the files, plus where the full docs are. */
+export function renderAgentsMd({ packageManager, version }) {
+    const pm = commandsFor(packageManager);
+    return `# AGENTS.md
+
+This is a Parlor ${version} app. Parlor changes faster than your training data: read
+${DOCS_URL}/llms.txt (every page, as Markdown) before changing how the app is wired.
+
+## Rules
+
+- Business logic lives only in \`actions/\` as \`defineAction\`. The UI calls actions with
+  \`useActionQuery\` and \`useActionMutation\` from \`@parlor/client/react\`, never \`fetch\`.
+- Every table has a \`scope\` column and every action filters by \`ctx.scope\`.
+- An action that changes data declares \`writes\`; one that reads declares \`reads\`. That is how
+  pages refresh when an agent changes something.
+- After changing \`schema/\`, run \`${pm.run("db:generate")}\` and commit the migration.
+- \`.parlor/\` is generated. Never edit it. There is no \`vite.config.ts\`: Vite options go in the
+  \`vite\` field of \`parlor.config.ts\`.
+- Add features with \`${pm.exec("parlor", ["add", "<auth|agent>"])}\` instead of wiring them by hand.
+
+## Commands
+
+- \`${pm.run("dev")}\`: runs until stopped; the app is on http://localhost:5173.
+- \`${pm.run("typecheck")}\` and \`${pm.run("test")}\` must pass before you finish.
+`;
+}
+//# sourceMappingURL=docs.js.map

package/dist/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../src/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAuB,MAAM,sBAAsB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAQxC,4EAA4E;AAC5E,MAAM,UAAU,YAAY,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAoB;IACzE,MAAM,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IACvC,OAAO,KAAK,QAAQ,CAAC,OAAO;;aAEjB,QAAQ;;;;;;EAMnB,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;;;;;;;;MAQT,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;MACb,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC;MACnB,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;MACd,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;MACrB,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC;MACf,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;MAClC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;;;;;;;;;gBASnC,QAAQ;CACvB,CAAC;AACF,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,cAAc,CAAC,EAAE,cAAc,EAAE,OAAO,EAAoB;IAC1E,MAAM,EAAE,GAAG,WAAW,CAAC,cAAc,CAAC,CAAC;IACvC,OAAO;;mBAEU,OAAO;EACxB,QAAQ;;;;;;;;;sCAS4B,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC;;;wBAGnC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC;;;;MAI5D,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC;MACb,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC;CAClD,CAAC;AACF,CAAC"}

package/dist/edit/inspect.d.ts

@@ -0,0 +1,15 @@
+import { type SourceFile } from "./source.js";
+export type Presence = "installed" | "absent" | "unknown";
+/**
+ * What the app's server entry passes to `createServer`, read from its syntax without running
+ * it. `unknown` when the shape hides it (options built elsewhere, spreads, a plugins variable),
+ * so every reader picks the behavior that is safe when it cannot tell.
+ */
+export interface ServerShape {
+    readonly auth: Presence;
+    readonly chat: Presence;
+}
+export declare const UNKNOWN_SERVER: ServerShape;
+export declare function inspectServer(file: SourceFile): ServerShape;
+export declare function inspectServerEntry(rootDir: string, entry: string): Promise<ServerShape>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/edit/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/edit/inspect.ts"],"names":[],"mappings":"AAKA,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAU3D,MAAM,MAAM,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,eAAO,MAAM,cAAc,EAAE,WAAkD,CAAC;AA8ChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,CAa3D;AAED,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAQtB"}

package/dist/edit/inspect.js

@@ -0,0 +1,73 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { parseSource } from "./source.js";
+import { findCall, importedName, objectArgument, propertyOf, valueOf, } from "./syntax.js";
+export const UNKNOWN_SERVER = { auth: "unknown", chat: "unknown" };
+const SERVER = { callee: "createServer", from: "@parlor/server" };
+const CHAT = { callee: "chat", from: "@parlor/chat/server" };
+/** A call, or a module-scope `const` bound once to a call; anything conditional is unknown. */
+function authPresence(file, value) {
+    if (value.type === "Identifier" && value.name === "undefined")
+        return "absent";
+    const unwrapped = value.type === "AwaitExpression" ? value.argument : value;
+    if (unwrapped.type === "CallExpression" || unwrapped.type === "NewExpression") {
+        return "installed";
+    }
+    if (value.type !== "Identifier")
+        return "unknown";
+    const declarators = file.ast.program.body.flatMap((statement) => {
+        const declaration = statement.type === "ExportNamedDeclaration" ? statement.declaration : statement;
+        return declaration?.type === "VariableDeclaration" && declaration.kind === "const"
+            ? declaration.declarations.filter((declarator) => declarator.id.type === "Identifier" && declarator.id.name === value.name)
+            : [];
+    });
+    const init = declarators.length === 1 ? declarators[0]?.init : undefined;
+    const call = init?.type === "AwaitExpression" ? init.argument : init;
+    return call?.type === "CallExpression" || call?.type === "NewExpression"
+        ? "installed"
+        : "unknown";
+}
+function chatPresence(file, plugins) {
+    if (plugins.type !== "ArrayExpression")
+        return "unknown";
+    if (plugins.elements.some((element) => element?.type === "SpreadElement"))
+        return "unknown";
+    const local = importedName(file, CHAT.callee, CHAT.from);
+    if (!local)
+        return "absent";
+    return plugins.elements.some((element) => element?.type === "CallExpression" &&
+        element.callee.type === "Identifier" &&
+        element.callee.name === local)
+        ? "installed"
+        : "absent";
+}
+export function inspectServer(file) {
+    const call = findCall(file, SERVER);
+    if (!call.ok)
+        return UNKNOWN_SERVER;
+    const argument = objectArgument(file, SERVER, call.value);
+    if (!argument.ok)
+        return UNKNOWN_SERVER;
+    if (argument.value.kind === "none")
+        return { auth: "absent", chat: "absent" };
+    const auth = propertyOf(file, argument.value.node, "auth");
+    const plugins = propertyOf(file, argument.value.node, "plugins");
+    if (!auth.ok || !plugins.ok)
+        return UNKNOWN_SERVER;
+    return {
+        auth: auth.value ? authPresence(file, valueOf(auth.value)) : "absent",
+        chat: plugins.value ? chatPresence(file, valueOf(plugins.value)) : "absent",
+    };
+}
+export async function inspectServerEntry(rootDir, entry) {
+    const text = await readFile(join(rootDir, entry), "utf8").catch(() => undefined);
+    if (text === undefined)
+        return UNKNOWN_SERVER;
+    try {
+        return inspectServer(parseSource(entry, text));
+    }
+    catch {
+        return UNKNOWN_SERVER;
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/edit/inspect.js.map

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

package/dist/edit/ops.d.ts

@@ -0,0 +1,92 @@
+import { type SourceFile, type Splice } from "./source.js";
+import { type CallSite } from "./syntax.js";
+export type { CallSite } from "./syntax.js";
+/**
+ * The closed set of code edits. Each one knows how to tell that it is already done, how to
+ * make it, and when it is unsafe. Add a kind here, with its tests, instead of editing text
+ * anywhere else.
+ */
+export type Op = 
+/** Joins an existing value import from `from`, else a new line where oxfmt's sorted imports put it. */
+{
+    readonly kind: "import";
+    readonly names: readonly string[];
+    readonly from: string;
+} | {
+    readonly kind: "export-all";
+    readonly from: string;
+}
+/** Present when an element starts with the same identifier: `chat()` is present when `chat(...)` is. */
+ | {
+    readonly kind: "append-element";
+    readonly call: CallSite;
+    readonly path: readonly [string, ...string[]];
+    readonly element: string;
+}
+/**
+ * `$name` in `value` is replaced with the source text of the sibling property `name`, so
+ * `createAuth($database)` follows whatever the app passes.
+ */
+ | {
+    readonly kind: "set-property";
+    readonly call: CallSite;
+    readonly path: readonly [string, ...string[]];
+    readonly value: string;
+    /** `unsafe` for add-ons, which never overwrite; `replace` for create's own template. */
+    readonly onConflict: "unsafe" | "replace";
+} | {
+    readonly kind: "wrap-property";
+    readonly call: CallSite;
+    readonly path: readonly [string, ...string[]];
+    readonly wrapper: string;
+} | {
+    readonly kind: "jsx-attribute";
+    readonly element: string;
+    readonly name: string;
+    readonly value: string;
+}
+/** The component must return exactly one JSX element or fragment. */
+ | {
+    readonly kind: "jsx-child";
+    readonly component: string;
+    readonly element: string;
+};
+export type OpOutcome = {
+    readonly status: "done";
+} | {
+    readonly status: "edit";
+    readonly splices: readonly Splice[];
+} | {
+    readonly status: "unsafe";
+    readonly reason: string;
+};
+export declare function evaluateOp(file: SourceFile, op: Op): OpOutcome;
+/** One short line for the printed plan, such as "auth: createAuth(database)"; none for an import. */
+export declare function opSummary(file: SourceFile, op: Op): string | undefined;
+/** The code to write by hand for `op`; a `$name` stands for the sibling the app passes. */
+export declare function manualCode(op: Op): string;
+export declare function indentLines(text: string, indent: string): string;
+/** The change to make by hand when `op` is unsafe. */
+export declare function manualChange(file: string, op: Op): string;
+export type EditOutcome = {
+    readonly status: "done";
+} | {
+    readonly status: "edit";
+    readonly text: string;
+} | {
+    readonly status: "unsafe";
+    readonly unsafe: readonly UnsafeOp[];
+};
+export interface UnsafeOp {
+    readonly op: Op;
+    readonly reason: string;
+}
+export declare const UNCONFIRMED = "could not confirm the edit";
+/**
+ * Applies `ops` in order, reparsing after each one, then proves the result: it must still
+ * parse and every op must now evaluate to `done`. A failed proof is `unsafe`, so a bug in an op
+ * can cost a manual step but never a broken or half-edited file, and a second run is a no-op
+ * by construction. Collects every unsafe op instead of stopping at the first.
+ */
+export declare function editSource(file: SourceFile, ops: readonly Op[]): EditOutcome;
+//# sourceMappingURL=ops.d.ts.map

package/dist/edit/ops.d.ts.map

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