@coreframe/scripts 0.1.0 → 0.1.2

package/dist/upgrade/ensure-template-remote.d.ts

@@ -1,6 +1,11 @@
-#!/usr/bin/env node
-export type EnsureTemplateRemoteOptions = {
-    fetch: boolean;
-    remote: string;
+//#region upgrade/ensure-template-remote.d.ts
+type EnsureTemplateRemoteOptions = {
+  fetch: boolean;
+  remote: string;
 };
-export declare function ensureTemplateRemote({ fetch, remote, }?: Partial<EnsureTemplateRemoteOptions>): void;
+declare function ensureTemplateRemote({
+  fetch,
+  remote
+}?: Partial<EnsureTemplateRemoteOptions>): void;
+//#endregion
+export { EnsureTemplateRemoteOptions, ensureTemplateRemote };

package/dist/upgrade/ensure-template-remote.js

@@ -1,57 +1,2 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-const defaultRemote = "template";
-const defaultUrl = "https://github.com/airlock-labs/coreframe.git";
-function git(args) {
-    return spawnSync("git", args, { encoding: "utf8" });
-}
-function runGit(args) {
-    const result = git(args);
-    if (result.status !== 0) {
-        const detail = result.stderr.trim() || result.stdout.trim();
-        throw new Error(`Git command failed: git ${args.join(" ")}${detail ? `\n${detail}` : ""}`);
-    }
-    return result.stdout;
-}
-function getRemoteUrl(remote) {
-    const result = git(["remote", "get-url", remote]);
-    if (result.status === 2) {
-        return null;
-    }
-    if (result.status !== 0) {
-        const detail = result.stderr.trim() || result.stdout.trim();
-        throw new Error(`Could not inspect remote ${remote}.${detail ? `\n${detail}` : ""}`);
-    }
-    return result.stdout.trim();
-}
-export function ensureTemplateRemote({ fetch = true, remote = defaultRemote, } = {}) {
-    if (remote.length === 0) {
-        throw new Error("Remote name must not be empty.");
-    }
-    runGit(["rev-parse", "--show-toplevel"]);
-    const existingUrl = getRemoteUrl(remote);
-    if (existingUrl === null) {
-        runGit(["remote", "add", remote, defaultUrl]);
-        console.log(`Added ${remote} remote: ${defaultUrl}`);
-    }
-    else if (existingUrl === defaultUrl) {
-        console.log(`${remote} remote already points at ${defaultUrl}`);
-    }
-    else {
-        throw new Error(`${remote} remote points at ${existingUrl}, not ${defaultUrl}.\n` +
-            "Choose the intended template source before continuing, then update or rename the remote manually.");
-    }
-    if (fetch) {
-        runGit(["fetch", remote, "--tags", "--prune"]);
-        console.log(`Fetched ${remote}.`);
-    }
-}
-if (import.meta.main) {
-    try {
-        ensureTemplateRemote({ fetch: !process.argv.includes("--no-fetch") });
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(65);
-    }
-}
+import{spawnSync as e}from"node:child_process";const t=`https://github.com/airlock-labs/coreframe.git`;function n(t){return e(`git`,t,{encoding:`utf8`})}function r(e){let t=n(e);if(t.status!==0){let n=t.stderr.trim()||t.stdout.trim();throw Error(`Git command failed: git ${e.join(` `)}${n?`\n${n}`:``}`)}return t.stdout}function i(e){let t=n([`remote`,`get-url`,e]);if(t.status===2)return null;if(t.status!==0){let n=t.stderr.trim()||t.stdout.trim();throw Error(`Could not inspect remote ${e}.${n?`\n${n}`:``}`)}return t.stdout.trim()}function a({fetch:e=!0,remote:n=`template`}={}){if(n.length===0)throw Error(`Remote name must not be empty.`);r([`rev-parse`,`--show-toplevel`]);let a=i(n);if(a===null)r([`remote`,`add`,n,t]),console.log(`Added ${n} remote: ${t}`);else if(a===t)console.log(`${n} remote already points at ${t}`);else throw Error(`${n} remote points at ${a}, not ${t}.\nChoose the intended template source before continuing, then update or rename the remote manually.`);e&&(r([`fetch`,n,`--tags`,`--prune`]),console.log(`Fetched ${n}.`))}if(import.meta.main)try{a({fetch:!process.argv.includes(`--no-fetch`)})}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(65)}export{a as ensureTemplateRemote};

package/dist/upgrade/fast-forward-template-files.d.ts

@@ -1,7 +1,9 @@
-#!/usr/bin/env node
-export type FastForwardTemplateFilesOptions = {
-    apply: boolean;
-    base?: string;
-    target: string;
+//#region upgrade/fast-forward-template-files.d.ts
+type FastForwardTemplateFilesOptions = {
+  apply: boolean;
+  base?: string;
+  target: string;
 };
-export declare function fastForwardTemplateFiles(args: FastForwardTemplateFilesOptions): void;
+declare function fastForwardTemplateFiles(args: FastForwardTemplateFilesOptions): void;
+//#endregion
+export { FastForwardTemplateFilesOptions, fastForwardTemplateFiles };

package/dist/upgrade/fast-forward-template-files.js

@@ -1,280 +1,2 @@
 #!/usr/bin/env node
-import { spawnSync } from "node:child_process";
-import { chmodSync, existsSync, lstatSync, mkdirSync, readFileSync, readlinkSync, rmSync, symlinkSync, writeFileSync, } from "node:fs";
-import { dirname, join, resolve, sep } from "node:path";
-const projectOwnedPathPrefixes = ["drizzle/", "drizzle-hold/"];
-const supportedModes = new Set(["100644", "100755", "120000"]);
-function git(args, options = {}) {
-    return spawnSync("git", args, options);
-}
-function gitText(args) {
-    const result = git(args, { encoding: "utf8" });
-    if (result.status !== 0) {
-        const detail = result.stderr.toString().trim() || result.stdout.toString().trim();
-        throw new Error(`Git command failed: git ${args.join(" ")}${detail ? `\n${detail}` : ""}`);
-    }
-    return result.stdout.toString();
-}
-function gitBuffer(args) {
-    const result = git(args);
-    if (result.status !== 0) {
-        const detail = result.stderr.toString("utf8").trim() || result.stdout.toString("utf8").trim();
-        throw new Error(`Git command failed: git ${args.join(" ")}${detail ? `\n${detail}` : ""}`);
-    }
-    return result.stdout;
-}
-function getRepoRoot() {
-    return gitText(["rev-parse", "--show-toplevel"]).trim();
-}
-function readPackageCoreframeVersion(repoRoot) {
-    const packagePath = join(repoRoot, "package.json");
-    if (!existsSync(packagePath)) {
-        throw new Error("Missing --base <git-ref>, and package.json does not exist.");
-    }
-    const packageJson = JSON.parse(readFileSync(packagePath, "utf8"));
-    const version = packageJson.engines?.coreframe;
-    if (typeof version !== "string" || version.length === 0) {
-        throw new Error("Missing --base <git-ref>, and package.json engines.coreframe is not set.");
-    }
-    return version;
-}
-function splitNullTerminated(buffer) {
-    const fields = [];
-    let start = 0;
-    for (let index = 0; index < buffer.length; index += 1) {
-        if (buffer[index] !== 0) {
-            continue;
-        }
-        fields.push(buffer.subarray(start, index).toString("utf8"));
-        start = index + 1;
-    }
-    return fields.filter((field) => field.length > 0);
-}
-function listChangedPaths(base, target) {
-    const output = gitBuffer(["diff", "--name-status", "-z", "--no-renames", base, target, "--"]);
-    const fields = splitNullTerminated(output);
-    const changes = [];
-    for (let index = 0; index < fields.length; index += 2) {
-        const status = fields[index];
-        const path = fields[index + 1];
-        if (!status || !path) {
-            throw new Error("Could not parse git diff --name-status output.");
-        }
-        changes.push({ path, status });
-    }
-    return changes;
-}
-function getGitEntry(ref, path) {
-    const output = gitBuffer(["ls-tree", "-z", ref, "--", path]);
-    if (output.length === 0) {
-        return null;
-    }
-    const record = splitNullTerminated(output)[0];
-    const tabIndex = record.indexOf("\t");
-    if (tabIndex === -1) {
-        throw new Error(`Could not parse git ls-tree output for ${ref}:${path}.`);
-    }
-    const [mode, type, object] = record.slice(0, tabIndex).split(" ");
-    if (!mode || !type || !object) {
-        throw new Error(`Could not parse git ls-tree metadata for ${ref}:${path}.`);
-    }
-    return { mode, object, path, type };
-}
-function readGitBlob(entry) {
-    return gitBuffer(["cat-file", "blob", entry.object]);
-}
-function safeWorktreePath(repoRoot, path) {
-    const absolutePath = resolve(repoRoot, path);
-    const rootPrefix = repoRoot.endsWith(sep) ? repoRoot : `${repoRoot}${sep}`;
-    if (absolutePath !== repoRoot && !absolutePath.startsWith(rootPrefix)) {
-        throw new Error(`Refusing to access path outside repository: ${path}`);
-    }
-    return absolutePath;
-}
-function pathExists(path) {
-    try {
-        lstatSync(path);
-        return true;
-    }
-    catch (error) {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-            return false;
-        }
-        throw error;
-    }
-}
-function isExecutable(stat) {
-    return (stat.mode & 0o111) !== 0;
-}
-function entryIsSupported(entry) {
-    return entry === null || (entry.type === "blob" && supportedModes.has(entry.mode));
-}
-function isProjectOwnedPath(path) {
-    return projectOwnedPathPrefixes.some((prefix) => path === prefix.slice(0, -1) || path.startsWith(prefix));
-}
-function currentMatchesEntry(repoRoot, path, entry) {
-    const worktreePath = safeWorktreePath(repoRoot, path);
-    if (entry === null) {
-        return { matches: !pathExists(worktreePath) };
-    }
-    if (!entryIsSupported(entry)) {
-        return { matches: false, reason: `unsupported template entry mode ${entry.mode} ${entry.type}` };
-    }
-    let stat;
-    try {
-        stat = lstatSync(worktreePath);
-    }
-    catch (error) {
-        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
-            return { matches: false, reason: "path is missing from worktree" };
-        }
-        throw error;
-    }
-    const expected = readGitBlob(entry);
-    if (entry.mode === "120000") {
-        if (!stat.isSymbolicLink()) {
-            return { matches: false, reason: "worktree path is not a symlink" };
-        }
-        const linkTarget = Buffer.from(readlinkSync(worktreePath), "utf8");
-        return { matches: linkTarget.equals(expected) };
-    }
-    if (!stat.isFile()) {
-        return { matches: false, reason: "worktree path is not a regular file" };
-    }
-    const executableMatches = entry.mode === "100755" ? isExecutable(stat) : !isExecutable(stat);
-    if (!executableMatches) {
-        return { matches: false, reason: "worktree executable bit differs from template" };
-    }
-    return { matches: readFileSync(worktreePath).equals(expected) };
-}
-function removeExistingPath(worktreePath) {
-    if (!pathExists(worktreePath)) {
-        return;
-    }
-    rmSync(worktreePath, { force: true, recursive: false });
-}
-function applyEntry(repoRoot, path, entry) {
-    const worktreePath = safeWorktreePath(repoRoot, path);
-    if (entry === null) {
-        removeExistingPath(worktreePath);
-        return;
-    }
-    mkdirSync(dirname(worktreePath), { recursive: true });
-    if (entry.mode === "120000") {
-        removeExistingPath(worktreePath);
-        symlinkSync(readGitBlob(entry).toString("utf8"), worktreePath);
-        return;
-    }
-    const stat = pathExists(worktreePath) ? lstatSync(worktreePath) : null;
-    if (stat && !stat.isFile()) {
-        removeExistingPath(worktreePath);
-    }
-    writeFileSync(worktreePath, readGitBlob(entry));
-    chmodSync(worktreePath, entry.mode === "100755" ? 0o755 : 0o644);
-}
-function actionFor(baseEntry, targetEntry) {
-    if (baseEntry === null && targetEntry !== null) {
-        return "add";
-    }
-    if (baseEntry !== null && targetEntry === null) {
-        return "delete";
-    }
-    return "update";
-}
-function printEntries(title, entries) {
-    if (entries.length === 0) {
-        return;
-    }
-    console.log(`${title}:`);
-    for (const entry of entries) {
-        const detail = entry.reason ? ` (${entry.reason})` : "";
-        console.log(`  ${entry.action}: ${entry.path}${detail}`);
-    }
-    console.log("");
-}
-export function fastForwardTemplateFiles(args) {
-    const repoRoot = getRepoRoot();
-    const base = args.base ?? readPackageCoreframeVersion(repoRoot);
-    const target = args.target;
-    const changes = listChangedPaths(base, target);
-    const clean = [];
-    const ignored = [];
-    const skipped = [];
-    const unchanged = [];
-    for (const change of changes) {
-        if (isProjectOwnedPath(change.path)) {
-            ignored.push({
-                action: "ignored",
-                path: change.path,
-                reason: "project-owned migration history",
-            });
-            continue;
-        }
-        const baseEntry = getGitEntry(base, change.path);
-        const targetEntry = getGitEntry(target, change.path);
-        const action = actionFor(baseEntry, targetEntry);
-        if (!entryIsSupported(baseEntry) || !entryIsSupported(targetEntry)) {
-            skipped.push({
-                action,
-                path: change.path,
-                reason: "unsupported template entry type",
-            });
-            continue;
-        }
-        const targetMatch = currentMatchesEntry(repoRoot, change.path, targetEntry);
-        if (targetMatch.matches) {
-            unchanged.push({ action: "unchanged", path: change.path });
-            continue;
-        }
-        const baseMatch = currentMatchesEntry(repoRoot, change.path, baseEntry);
-        if (!baseMatch.matches) {
-            skipped.push({
-                action,
-                path: change.path,
-                reason: baseMatch.reason ?? "downstream differs from base template",
-            });
-            continue;
-        }
-        clean.push({ action, path: change.path, targetEntry });
-    }
-    if (args.apply) {
-        for (const entry of clean) {
-            applyEntry(repoRoot, entry.path, entry.targetEntry ?? null);
-        }
-    }
-    console.log(`Coreframe template fast-forward: ${base} -> ${target}`);
-    console.log("");
-    printEntries(args.apply ? "Applied clean template updates" : "Would apply clean template updates", clean);
-    printEntries("Ignored project-owned paths", ignored);
-    printEntries("Skipped for agent review", skipped);
-    if (unchanged.length > 0) {
-        console.log(`${unchanged.length} changed template path(s) already matched the target state.`);
-    }
-    if (changes.length === 0) {
-        console.log("No template file changes found in the requested range.");
-    }
-    if (!args.apply && clean.length > 0) {
-        console.log("");
-        console.log(`Run with --apply to write the ${clean.length} clean update(s).`);
-    }
-}
-if (import.meta.main) {
-    const targetIndex = process.argv.indexOf("--target");
-    const target = targetIndex === -1 ? null : process.argv[targetIndex + 1];
-    if (!target) {
-        console.error("Usage: coreframe upgrade fast-forward-template-files --target <git-ref> [--base <git-ref>] [--apply]");
-        process.exit(64);
-    }
-    try {
-        const baseIndex = process.argv.indexOf("--base");
-        fastForwardTemplateFiles({
-            apply: process.argv.includes("--apply"),
-            base: baseIndex === -1 ? undefined : process.argv[baseIndex + 1],
-            target,
-        });
-    }
-    catch (error) {
-        console.error(error instanceof Error ? error.message : String(error));
-        process.exit(65);
-    }
-}
+import{dirname as e,join as t,resolve as n,sep as r}from"node:path";import{chmodSync as i,existsSync as a,lstatSync as o,mkdirSync as s,readFileSync as c,readlinkSync as l,rmSync as u,symlinkSync as d,writeFileSync as f}from"node:fs";import{spawnSync as p}from"node:child_process";const m=[`drizzle/`,`drizzle-hold/`],h=new Set([`100644`,`100755`,`120000`]);function g(e,t={}){return p(`git`,e,t)}function _(e){let t=g(e,{encoding:`utf8`});if(t.status!==0){let n=t.stderr.toString().trim()||t.stdout.toString().trim();throw Error(`Git command failed: git ${e.join(` `)}${n?`\n${n}`:``}`)}return t.stdout.toString()}function v(e){let t=g(e);if(t.status!==0){let n=t.stderr.toString(`utf8`).trim()||t.stdout.toString(`utf8`).trim();throw Error(`Git command failed: git ${e.join(` `)}${n?`\n${n}`:``}`)}return t.stdout}function y(){return _([`rev-parse`,`--show-toplevel`]).trim()}function b(e){let n=t(e,`package.json`);if(!a(n))throw Error(`Missing --base <git-ref>, and package.json does not exist.`);let r=JSON.parse(c(n,`utf8`)).engines?.coreframe;if(typeof r!=`string`||r.length===0)throw Error(`Missing --base <git-ref>, and package.json engines.coreframe is not set.`);return r}function x(e){let t=[],n=0;for(let r=0;r<e.length;r+=1)e[r]===0&&(t.push(e.subarray(n,r).toString(`utf8`)),n=r+1);return t.filter(e=>e.length>0)}function S(e,t){let n=x(v([`diff`,`--name-status`,`-z`,`--no-renames`,e,t,`--`])),r=[];for(let e=0;e<n.length;e+=2){let t=n[e],i=n[e+1];if(!t||!i)throw Error(`Could not parse git diff --name-status output.`);r.push({path:i,status:t})}return r}function C(e,t){let n=v([`ls-tree`,`-z`,e,`--`,t]);if(n.length===0)return null;let r=x(n)[0],i=r.indexOf(`	`);if(i===-1)throw Error(`Could not parse git ls-tree output for ${e}:${t}.`);let[a,o,s]=r.slice(0,i).split(` `);if(!a||!o||!s)throw Error(`Could not parse git ls-tree metadata for ${e}:${t}.`);return{mode:a,object:s,path:t,type:o}}function w(e){return v([`cat-file`,`blob`,e.object])}function T(e,t){let i=n(e,t),a=e.endsWith(r)?e:`${e}${r}`;if(i!==e&&!i.startsWith(a))throw Error(`Refusing to access path outside repository: ${t}`);return i}function E(e){try{return o(e),!0}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return!1;throw e}}function D(e){return(e.mode&73)!=0}function O(e){return e===null||e.type===`blob`&&h.has(e.mode)}function k(e){return m.some(t=>e===t.slice(0,-1)||e.startsWith(t))}function A(e,t,n){let r=T(e,t);if(n===null)return{matches:!E(r)};if(!O(n))return{matches:!1,reason:`unsupported template entry mode ${n.mode} ${n.type}`};let i;try{i=o(r)}catch(e){if(e instanceof Error&&`code`in e&&e.code===`ENOENT`)return{matches:!1,reason:`path is missing from worktree`};throw e}let a=w(n);return n.mode===`120000`?i.isSymbolicLink()?{matches:Buffer.from(l(r),`utf8`).equals(a)}:{matches:!1,reason:`worktree path is not a symlink`}:i.isFile()?(n.mode===`100755`?D(i):!D(i))?{matches:c(r).equals(a)}:{matches:!1,reason:`worktree executable bit differs from template`}:{matches:!1,reason:`worktree path is not a regular file`}}function j(e){E(e)&&u(e,{force:!0,recursive:!1})}function M(t,n,r){let a=T(t,n);if(r===null){j(a);return}if(s(e(a),{recursive:!0}),r.mode===`120000`){j(a),d(w(r).toString(`utf8`),a);return}let c=E(a)?o(a):null;c&&!c.isFile()&&j(a),f(a,w(r)),i(a,r.mode===`100755`?493:420)}function N(e,t){return e===null&&t!==null?`add`:e!==null&&t===null?`delete`:`update`}function P(e,t){if(t.length!==0){console.log(`${e}:`);for(let e of t){let t=e.reason?` (${e.reason})`:``;console.log(`  ${e.action}: ${e.path}${t}`)}console.log(``)}}function F(e){let t=y(),n=e.base??b(t),r=e.target,i=S(n,r),a=[],o=[],s=[],c=[];for(let e of i){if(k(e.path)){o.push({action:`ignored`,path:e.path,reason:`project-owned migration history`});continue}let i=C(n,e.path),l=C(r,e.path),u=N(i,l);if(!O(i)||!O(l)){s.push({action:u,path:e.path,reason:`unsupported template entry type`});continue}if(A(t,e.path,l).matches){c.push({action:`unchanged`,path:e.path});continue}let d=A(t,e.path,i);if(!d.matches){s.push({action:u,path:e.path,reason:d.reason??`downstream differs from base template`});continue}a.push({action:u,path:e.path,targetEntry:l})}if(e.apply)for(let e of a)M(t,e.path,e.targetEntry??null);console.log(`Coreframe template fast-forward: ${n} -> ${r}`),console.log(``),P(e.apply?`Applied clean template updates`:`Would apply clean template updates`,a),P(`Ignored project-owned paths`,o),P(`Skipped for agent review`,s),c.length>0&&console.log(`${c.length} changed template path(s) already matched the target state.`),i.length===0&&console.log(`No template file changes found in the requested range.`),!e.apply&&a.length>0&&(console.log(``),console.log(`Run with --apply to write the ${a.length} clean update(s).`))}if(import.meta.main){let e=process.argv.indexOf(`--target`),t=e===-1?null:process.argv[e+1];t||(console.error(`Usage: coreframe upgrade fast-forward-template-files --target <git-ref> [--base <git-ref>] [--apply]`),process.exit(64));try{let e=process.argv.indexOf(`--base`);F({apply:process.argv.includes(`--apply`),base:e===-1?void 0:process.argv[e+1],target:t})}catch(e){console.error(e instanceof Error?e.message:String(e)),process.exit(65)}}export{F as fastForwardTemplateFiles};

package/package.json

@@ -1,9 +1,13 @@
 {
   "name": "@coreframe/scripts",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "bin": {
     "coreframe": "./bin/coreframe.js"
   },
+  "files": [
+    "bin/",
+    "dist/"
+  ],
   "type": "module",
   "repository": {
     "type": "git",
@@ -17,7 +21,7 @@
     }
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json",
+    "build": "tsdown",
     "test": "vitest run",
     "typecheck": "tsc --noEmit -p tsconfig.json",
     "format": "oxfmt",
@@ -34,6 +38,7 @@
   "devDependencies": {
     "@types/node": "^26.1.0",
     "sharp": "^0.34.5",
+    "tsdown": "0.22.3",
     "typescript": "6.0.3",
     "vite": "^8.1.0",
     "vitest": "^4.1.9"

package/config.test.ts

@@ -1,15 +0,0 @@
-import { describe, expect, it } from "vitest"
-
-import { defineConfig } from "./config.ts"
-
-describe("defineConfig", () => {
-  it("returns a typed Coreframe config object", () => {
-    const config = defineConfig({
-      deploy: {
-        smokeChecks: [{ name: "home", path: "/" }],
-      },
-    })
-
-    expect(config.deploy?.smokeChecks).toEqual([{ name: "home", path: "/" }])
-  })
-})

package/config.ts

@@ -1,9 +0,0 @@
-import type { DeployConfig } from "./deploy/config.ts"
-
-export type CoreframeConfig = {
-  deploy?: DeployConfig
-}
-
-export function defineConfig(config: CoreframeConfig) {
-  return config
-}