mirror of
https://github.com/hanzoai/frames.git
synced 2026-09-24 00:08:03 +00:00
zooqueenandHanzo Dev
70b41673a3
Forked from HyperFrames (Apache-2.0), full history preserved. Hosts are mapped explicitly and BEFORE the identifier rename, because hyperframes.heygen.com is not decoration: 175 of its occurrences are $schema identifiers that a validator dereferences. A blind rename would have left them naming a host that never serves them. The schema files are in this repo under docs/schema, so the mapped host is one we can actually serve -- that is the condition that makes the rewrite safe, and serving them is a deploy task, not an edit. docs/schema/hyperframes.json is renamed to frames.json to match the identifier it is now published under. api.heygen.com and the CLI auth against heygen.com are left UNRENAMED on purpose. They are a dependency on HeyGen's SaaS, not a name of ours to take, and the right move is to remove that integration rather than rebrand it. LICENSE and CREDITS.md are untouched; NOTICE records the lineage. Co-authored-by: Hanzo Dev <[email protected]>
87 lines
3.4 KiB
TypeScript
87 lines
3.4 KiB
TypeScript
// Generate (or verify) skills-manifest.json (repo root) — the published
|
|
// "latest" fingerprint of the Frames skill bundle.
|
|
//
|
|
// bun run --cwd packages/cli gen:skills-manifest # write/update
|
|
// bun run --cwd packages/cli gen:skills-manifest --check # verify only (CI)
|
|
//
|
|
// The manifest is just per-skill content hashes (no version / timestamp), so it
|
|
// is fully deterministic: same skill content ⇒ byte-identical manifest. `--check`
|
|
// exits non-zero when the committed manifest doesn't match current skill content.
|
|
|
|
import { readFileSync, writeFileSync } from "node:fs";
|
|
import { dirname, join } from "node:path";
|
|
import { fileURLToPath } from "node:url";
|
|
import { buildManifest, MANIFEST_FILE, type SkillsManifest } from "../src/utils/skillsManifest.js";
|
|
|
|
const here = dirname(fileURLToPath(import.meta.url));
|
|
const repoRoot = join(here, "..", "..", ".."); // packages/cli/scripts → repo root
|
|
const skillsRoot = join(repoRoot, "skills");
|
|
const outPath = join(repoRoot, MANIFEST_FILE);
|
|
const isCheck = process.argv.includes("--check");
|
|
|
|
/** Stable signature of the content hashes (order-independent). */
|
|
function signature(skills: SkillsManifest["skills"]): string {
|
|
return Object.keys(skills)
|
|
.sort()
|
|
.map((name) => `${name}:${skills[name]!.hash}`)
|
|
.join("\n");
|
|
}
|
|
|
|
function driftLine(name: string, oldHash?: string, newHash?: string): string | null {
|
|
if (oldHash === newHash) return null;
|
|
if (!oldHash) return ` + ${name} (new)`;
|
|
if (!newHash) return ` - ${name} (removed)`;
|
|
return ` ~ ${name} (${oldHash} → ${newHash})`;
|
|
}
|
|
|
|
function hashOf(skills: SkillsManifest["skills"], name: string): string | undefined {
|
|
return skills[name]?.hash;
|
|
}
|
|
|
|
function reportDrift(fresh: SkillsManifest, committed: SkillsManifest | null): void {
|
|
const oldSkills = committed === null ? {} : committed.skills;
|
|
const names = [...new Set([...Object.keys(fresh.skills), ...Object.keys(oldSkills)])].sort();
|
|
for (const name of names) {
|
|
const line = driftLine(name, hashOf(oldSkills, name), hashOf(fresh.skills, name));
|
|
if (line) console.log(line);
|
|
}
|
|
}
|
|
|
|
const fresh = buildManifest(skillsRoot, { source: "hanzoai/frames" });
|
|
|
|
// Read the committed manifest directly (no existsSync precheck) so there's no
|
|
// check-then-write race on outPath — a missing or unreadable file just means
|
|
// "no committed manifest yet", and we write a fresh one below.
|
|
let committed: SkillsManifest | null = null;
|
|
try {
|
|
committed = JSON.parse(readFileSync(outPath, "utf8")) as SkillsManifest;
|
|
} catch {
|
|
committed = null;
|
|
}
|
|
|
|
const inSync = committed !== null && signature(committed.skills) === signature(fresh.skills);
|
|
const count = Object.keys(fresh.skills).length;
|
|
|
|
if (isCheck) {
|
|
if (inSync) {
|
|
console.log(`✓ ${MANIFEST_FILE} is in sync (${count} skills)`);
|
|
process.exit(0);
|
|
}
|
|
console.error(`✗ ${MANIFEST_FILE} is out of date — a skill changed without regenerating it.`);
|
|
reportDrift(fresh, committed);
|
|
console.error(
|
|
`\nRun: bun run --cwd packages/cli gen:skills-manifest (then commit ${MANIFEST_FILE})`,
|
|
);
|
|
process.exit(1);
|
|
}
|
|
|
|
// Write mode — churn-free: only rewrite when a content hash actually changed.
|
|
if (inSync) {
|
|
console.log(`${MANIFEST_FILE} already in sync — no change (${count} skills)`);
|
|
process.exit(0);
|
|
}
|
|
|
|
writeFileSync(outPath, JSON.stringify(fresh, null, 2) + "\n");
|
|
console.log(`Wrote ${outPath} (${count} skills)`);
|
|
reportDrift(fresh, committed);
|