@jstn-sdk/ma 0.1.4 → 0.1.5

package/scripts/release-sync.js

@@ -1,359 +0,0 @@
-#!/usr/bin/env node
-
-import { execFileSync } from "node:child_process";
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-const WATCHED_PREFIXES = [
-  "bin/",
-  "docs/",
-  "example/",
-  "mcp/",
-  "missions/",
-  "plugins/",
-  "prompts/",
-  ".codex/prompts/",
-  "sprint/",
-  "templates/",
-  "src/",
-  "skills/",
-];
-
-const WATCHED_FILES = new Set([
-  "README.md",
-  "RELEASE.md",
-  "CHANGELOG.md",
-  "package.json",
-  "package-lock.json",
-]);
-
-function parseArgs(argv) {
-  const args = {
-    bump: "",
-    fromRef: "",
-    toRef: "",
-    githubOutput: "",
-    force: false,
-  };
-
-  for (let index = 0; index < argv.length; index += 1) {
-    const token = argv[index];
-    if (token === "--bump") {
-      args.bump = argv[index + 1] ?? "";
-      index += 1;
-      continue;
-    }
-    if (token === "--from-ref") {
-      args.fromRef = argv[index + 1] ?? "";
-      index += 1;
-      continue;
-    }
-    if (token === "--to-ref") {
-      args.toRef = argv[index + 1] ?? "";
-      index += 1;
-      continue;
-    }
-    if (token === "--github-output") {
-      args.githubOutput = argv[index + 1] ?? "";
-      index += 1;
-      continue;
-    }
-    if (token === "--force") {
-      args.force = true;
-    }
-  }
-
-  return args;
-}
-
-function readJson(file) {
-  return JSON.parse(fs.readFileSync(file, "utf8"));
-}
-
-function writeJson(file, value) {
-  fs.writeFileSync(file, `${JSON.stringify(value, null, 2)}\n`);
-}
-
-function readText(file) {
-  return fs.readFileSync(file, "utf8");
-}
-
-function writeText(file, content) {
-  fs.writeFileSync(file, content);
-}
-
-function replaceRequired(text, search, replacement, label) {
-  if (!text.includes(search)) {
-    throw new Error(`Expected to find ${label}: ${search}`);
-  }
-  return text.replaceAll(search, replacement);
-}
-
-function parseVersion(version) {
-  const match = version.match(/^(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)$/);
-  if (!match?.groups) {
-    throw new Error(`Unsupported version for release-sync: ${version}`);
-  }
-  return {
-    major: Number(match.groups.major),
-    minor: Number(match.groups.minor),
-    patch: Number(match.groups.patch),
-  };
-}
-
-function bumpVersion(version, bumpKind) {
-  const parsed = parseVersion(version);
-  if (bumpKind === "major") {
-    return `${parsed.major + 1}.0.0`;
-  }
-  if (bumpKind === "minor") {
-    return `${parsed.major}.${parsed.minor + 1}.0`;
-  }
-  return `${parsed.major}.${parsed.minor}.${parsed.patch + 1}`;
-}
-
-function git(args) {
-  return execFileSync("git", args, { encoding: "utf8" }).trim();
-}
-
-function getChangedFiles({ fromRef, toRef, force }) {
-  if (process.env.RELEASE_SYNC_CHANGED_FILES) {
-    return process.env.RELEASE_SYNC_CHANGED_FILES.split("\n")
-      .map((line) => line.trim())
-      .filter(Boolean);
-  }
-
-  if (force) {
-    return [];
-  }
-
-  if (fromRef && toRef && !/^0+$/.test(fromRef)) {
-    return git(["diff", "--name-only", fromRef, toRef])
-      .split("\n")
-      .map((line) => line.trim())
-      .filter(Boolean);
-  }
-
-  return git(["status", "--porcelain"])
-    .split("\n")
-    .map((line) => line.slice(3).trim())
-    .filter(Boolean);
-}
-
-function isWatchedPath(file) {
-  return WATCHED_FILES.has(file) || WATCHED_PREFIXES.some((prefix) => file.startsWith(prefix));
-}
-
-function prependChangelog(version) {
-  const changelogPath = "CHANGELOG.md";
-  const changelog = readText(changelogPath);
-  if (changelog.includes(`## v${version}`)) {
-    return;
-  }
-
-  const next = changelog.replace(
-    "# Changelog\n\n",
-    `# Changelog\n\n## v${version}\n\n- Release line prepared automatically for v${version}.\n\n`,
-  );
-  writeText(changelogPath, next);
-}
-
-function updateCurrentSurfaceFile(file, oldVersion, nextVersion) {
-  const oldTag = `v${oldVersion}`;
-  const nextTag = `v${nextVersion}`;
-  const oldQa = `release-readiness-${oldVersion}.md`;
-  const nextQa = `release-readiness-${nextVersion}.md`;
-  let content = readText(file);
-  if (content.includes(oldTag)) {
-    content = content.replaceAll(oldTag, nextTag);
-  }
-  if (content.includes(oldVersion)) {
-    content = content.replaceAll(oldVersion, nextVersion);
-  }
-  content = content.replaceAll(oldQa, nextQa);
-  writeText(file, content);
-}
-
-function syncPackageVersion(nextVersion) {
-  const pkg = readJson("package.json");
-  const lock = readJson("package-lock.json");
-  pkg.version = nextVersion;
-  lock.version = nextVersion;
-  if (lock.packages?.[""]) {
-    lock.packages[""].version = nextVersion;
-  }
-  writeJson("package.json", pkg);
-  writeJson("package-lock.json", lock);
-}
-
-function syncPluginVersions(nextVersion) {
-  for (const file of [
-    path.join("plugins", "meta-architect", ".app.json"),
-    path.join("plugins", "meta-architect", ".mcp.json"),
-    path.join("plugins", "meta-architect", ".codex-plugin", "plugin.json"),
-  ]) {
-    const value = readJson(file);
-    value.version = nextVersion;
-    writeJson(file, value);
-  }
-}
-
-function syncCurrentReleaseFiles(oldVersion, nextVersion) {
-  for (const file of [
-    "README.md",
-    "RELEASE.md",
-    path.join("docs", "README.md"),
-    path.join("docs", "getting-started.md"),
-    path.join("docs", "release-spec.md"),
-    path.join("plugins", "meta-architect", "README.md"),
-  ]) {
-    updateCurrentSurfaceFile(file, oldVersion, nextVersion);
-  }
-
-  const oldQa = path.join("docs", "qa", `release-readiness-${oldVersion}.md`);
-  const nextQa = path.join("docs", "qa", `release-readiness-${nextVersion}.md`);
-  fs.renameSync(oldQa, nextQa);
-  updateCurrentSurfaceFile(nextQa, oldVersion, nextVersion);
-}
-
-function syncSupportingCode(oldVersion, nextVersion) {
-  const replacements = [
-    {
-      file: path.join("src", "skills.js"),
-      search: `release-readiness-${oldVersion}.md`,
-      replacement: `release-readiness-${nextVersion}.md`,
-      label: "skills QA path",
-    },
-    {
-      file: path.join("src", "mcp-live-client.js"),
-      search: `version: "${oldVersion}"`,
-      replacement: `version: "${nextVersion}"`,
-      label: "mcp live client version",
-    },
-    {
-      file: path.join("test", "package-install-smoke.test.js"),
-      search: `jstn-sdk-ma-${oldVersion}.tgz`,
-      replacement: `jstn-sdk-ma-${nextVersion}.tgz`,
-      label: "tarball filename",
-    },
-    {
-      file: path.join("test", "policy.test.js"),
-      search: `release/${oldVersion}`,
-      replacement: `release/${nextVersion}`,
-      label: "release branch example",
-    },
-  ];
-
-  for (const entry of replacements) {
-    const content = readText(entry.file);
-    writeText(entry.file, replaceRequired(content, entry.search, entry.replacement, entry.label));
-  }
-}
-
-function rewriteReleaseState(nextVersion, previousVersion) {
-  const releasePath = "RELEASE.md";
-  const qaPath = path.join("docs", "qa", `release-readiness-${nextVersion}.md`);
-
-  let release = readText(releasePath);
-  release = release.replace(
-    /- npm package: `@jstn-sdk\/ma@[0-9]+\.[0-9]+\.[0-9]+`/,
-    `- npm package: \`@jstn-sdk/ma@${nextVersion}\``,
-  );
-  release = release.replace(
-    /- publishability note: .+/,
-    `- publishability note: \`${previousVersion}\` is already published, so \`${nextVersion}\` is the next publishable package line`,
-  );
-  release = release.replace(
-    /- GitHub release: .+/,
-    `- GitHub release: pending publish for \`v${nextVersion}\``,
-  );
-  release = release.replace(
-    /- npm publication has not been run yet for `@jstn-sdk\/ma@[0-9]+\.[0-9]+\.[0-9]+`/,
-    `- npm publication has not been run yet for \`@jstn-sdk/ma@${nextVersion}\``,
-  );
-  writeText(releasePath, release);
-
-  let qa = readText(qaPath);
-  qa = qa.replace(
-    /- npm package: `@jstn-sdk\/ma@[0-9]+\.[0-9]+\.[0-9]+`/,
-    `- npm package: \`@jstn-sdk/ma@${nextVersion}\``,
-  );
-  qa = qa.replace(
-    /- publishability note: .+/,
-    `- publishability note: \`${previousVersion}\` is already published, so \`${nextVersion}\` is the next publishable package line`,
-  );
-  qa = qa.replace(
-    /- GitHub release: .+/,
-    `- GitHub release: pending publish for \`v${nextVersion}\``,
-  );
-  writeText(qaPath, qa);
-}
-
-function writeGithubOutput(outputPath, { updated, version }) {
-  const lines = [`updated=${updated}`, `version=${version}`];
-  fs.appendFileSync(outputPath, `${lines.join("\n")}\n`);
-}
-
-function main() {
-  const args = parseArgs(process.argv.slice(2));
-  const pkg = readJson("package.json");
-  const currentVersion = pkg.version;
-  const changedFiles = getChangedFiles(args);
-  const relevantChanges = args.force ? ["<forced>"] : changedFiles.filter(isWatchedPath);
-
-  if (relevantChanges.length === 0 && !args.force) {
-    if (args.githubOutput) {
-      writeGithubOutput(args.githubOutput, { updated: "false", version: currentVersion });
-    }
-    console.log(
-      JSON.stringify(
-        {
-          updated: false,
-          forced: false,
-          version: currentVersion,
-          changedFiles,
-        },
-        null,
-        2,
-      ),
-    );
-    return;
-  }
-
-  const bumpKind = args.bump || "patch";
-  const nextVersion = bumpVersion(currentVersion, bumpKind);
-
-  syncPackageVersion(nextVersion);
-  syncPluginVersions(nextVersion);
-  prependChangelog(nextVersion);
-  syncCurrentReleaseFiles(currentVersion, nextVersion);
-  syncSupportingCode(currentVersion, nextVersion);
-  rewriteReleaseState(nextVersion, currentVersion);
-
-  if (args.githubOutput) {
-    writeGithubOutput(args.githubOutput, { updated: "true", version: nextVersion });
-  }
-
-  console.log(
-    JSON.stringify(
-      {
-        updated: true,
-        forced: args.force,
-        bump: bumpKind,
-        previousVersion: currentVersion,
-        version: nextVersion,
-        changedFiles: relevantChanges,
-      },
-      null,
-      2,
-    ),
-  );
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exitCode = 1;
-}

package/scripts/release-verify.js

@@ -1,153 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs";
-import path from "node:path";
-import process from "node:process";
-
-const CANONICAL_PACKAGE = "@jstn-sdk/ma";
-const CANONICAL_INSTALL = "npm i -g @openai/codex@latest @jstn-sdk/ma@latest";
-const CANONICAL_LAUNCH = "ma --madmax --high";
-const UNINSTALL_MA = "npm uninstall -g @jstn-sdk/ma";
-const UNINSTALL_BOTH = "npm uninstall -g @jstn-sdk/ma @openai/codex";
-
-function readJson(file) {
-  return JSON.parse(fs.readFileSync(file, "utf8"));
-}
-
-function readText(file) {
-  return fs.readFileSync(file, "utf8");
-}
-
-function fail(message) {
-  throw new Error(message);
-}
-
-function assert(condition, message) {
-  if (!condition) {
-    fail(message);
-  }
-}
-
-function parseVersion(version) {
-  const match = version.match(
-    /^(?<major>\d+)\.(?<minor>\d+)\.(?<patch>\d+)(?:-(?<prerelease>[0-9A-Za-z.-]+))?$/,
-  );
-  if (!match?.groups) {
-    fail(`Invalid package version: ${version}`);
-  }
-  return match.groups;
-}
-
-function verifyInstallBlock(file) {
-  const content = readText(file);
-  if (!content.includes(CANONICAL_INSTALL)) {
-    return;
-  }
-
-  assert(content.includes(CANONICAL_LAUNCH), `${file}: missing canonical launch command`);
-  assert(content.includes(UNINSTALL_MA), `${file}: missing uninstall Meta-Architect command`);
-  assert(
-    content.includes(UNINSTALL_BOTH),
-    `${file}: missing uninstall Meta-Architect + Codex command`,
-  );
-}
-
-function main() {
-  const pkg = readJson("package.json");
-  const lock = readJson("package-lock.json");
-  const version = pkg.version;
-  const gitTag = `v${version}`;
-  const parsed = parseVersion(version);
-  const isPrerelease = Boolean(parsed.prerelease);
-
-  assert(pkg.name === CANONICAL_PACKAGE, "package.json: wrong package name");
-  assert(lock.name === CANONICAL_PACKAGE, "package-lock.json: wrong package name");
-  assert(lock.version === version, "package-lock.json: version drift from package.json");
-  assert(lock.packages?.[""]?.version === version, "package-lock.json: root package version drift");
-  assert(
-    pkg.publishConfig?.access === "public",
-    "package.json: publishConfig.access must be public",
-  );
-
-  const changelog = readText("CHANGELOG.md");
-  assert(changelog.includes(`## ${gitTag}`), "CHANGELOG.md: missing current version heading");
-
-  const release = readText("RELEASE.md");
-  assert(release.includes(`# Meta-Architect ${gitTag}`), "RELEASE.md: wrong title version");
-
-  const releaseSpec = readText(path.join("docs", "release-spec.md"));
-  assert(
-    releaseSpec.includes(`# ${gitTag} Requirements & Rules`),
-    "docs/release-spec.md: wrong title version",
-  );
-  assert(
-    releaseSpec.includes(`package.json\` version \`${version}\``) ||
-      releaseSpec.includes(`package.json\` version \`${version}`),
-    "docs/release-spec.md: missing package version reference",
-  );
-  assert(
-    releaseSpec.includes(`git tag \`${gitTag}\``),
-    "docs/release-spec.md: missing git tag reference",
-  );
-
-  const qaPath = path.join("docs", "qa", `release-readiness-${version}.md`);
-  assert(fs.existsSync(qaPath), `Missing QA release-readiness file: ${qaPath}`);
-  const qa = readText(qaPath);
-  assert(qa.includes(`# Release Readiness ${version}`), `${qaPath}: wrong title version`);
-
-  const pluginApp = readJson(path.join("plugins", "meta-architect", ".app.json"));
-  const pluginMcp = readJson(path.join("plugins", "meta-architect", ".mcp.json"));
-  const pluginManifest = readJson(
-    path.join("plugins", "meta-architect", ".codex-plugin", "plugin.json"),
-  );
-  assert(pluginApp.version === version, "plugins/meta-architect/.app.json: version drift");
-  assert(pluginMcp.version === version, "plugins/meta-architect/.mcp.json: version drift");
-  assert(
-    pluginManifest.version === version,
-    "plugins/meta-architect/.codex-plugin/plugin.json: version drift",
-  );
-
-  for (const file of [
-    "README.md",
-    path.join("docs", "getting-started.md"),
-    path.join("docs", "onboarding.md"),
-    path.join("docs", "skills.md"),
-    path.join("plugins", "meta-architect", "README.md"),
-  ]) {
-    verifyInstallBlock(file);
-  }
-
-  const envTag =
-    process.env.RELEASE_TAG || process.env.GITHUB_REF_NAME || process.env.GIT_TAG || "";
-  if (envTag.startsWith("v")) {
-    assert(envTag === gitTag, `Release tag mismatch: expected ${gitTag}, got ${envTag}`);
-  }
-
-  if (isPrerelease) {
-    const prereleaseTag = parsed.prerelease.split(".")[0];
-    assert(
-      prereleaseTag && prereleaseTag !== "latest",
-      `Prerelease version ${version} must resolve to an explicit non-latest dist-tag`,
-    );
-  }
-
-  console.log(
-    JSON.stringify(
-      {
-        name: pkg.name,
-        version,
-        gitTag,
-        isPrerelease,
-      },
-      null,
-      2,
-    ),
-  );
-}
-
-try {
-  main();
-} catch (error) {
-  console.error(error.message);
-  process.exitCode = 1;
-}

package/scripts/setup-npmrc.js

@@ -1,39 +0,0 @@
-#!/usr/bin/env node
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import process from "node:process";
-
-function normalizeRegistry(registryUrl) {
-  return registryUrl.endsWith("/") ? registryUrl : `${registryUrl}/`;
-}
-
-async function main() {
-  const token = process.env.NPM_TOKEN || process.env.NODE_AUTH_TOKEN;
-  if (!token) {
-    console.log("No npm token detected. Skipping .npmrc generation.");
-    return;
-  }
-
-  const registry = normalizeRegistry(process.env.NPM_REGISTRY_URL || "https://registry.npmjs.org/");
-  const scope = process.env.NPM_SCOPE || "";
-  const host = new URL(registry).host;
-  const npmrcPath = path.join(process.cwd(), ".npmrc");
-
-  const content = [
-    `registry=${registry}`,
-    ...(scope ? [`${scope}:registry=${registry}`] : []),
-    `//${host}/:_authToken=${token}`,
-    "",
-  ].join("\n");
-
-  await fs.writeFile(npmrcPath, content, "utf8");
-  console.log(
-    `Wrote CI .npmrc for ${scope ? `scope ${scope}` : "the canonical unscoped package"}.`,
-  );
-}
-
-main().catch((error) => {
-  console.error(error.message);
-  process.exitCode = 1;
-});

package/skills/arch/SKILL.md

@@ -1,27 +0,0 @@
----
-name: arch
-description: "Use when the user wants architecture-first product and system design with explicit stack rationale, boundaries, tradeoffs, data model choices, and phased delivery planning."
----
-
-# Arch
-
-Use this skill inside Codex to turn a product idea into a concrete architecture brief.
-
-## Output
-
-Produce:
-- problem framing
-- user and workload assumptions
-- system architecture and subsystem boundaries
-- stack recommendation with tradeoffs
-- data model and storage choices
-- auth, security, and operational concerns
-- phased delivery plan
-- top risks and open questions
-- exact next trigger, usually `$sage`
-
-## Rules
-
-- Ask only for constraints that materially change the architecture.
-- Keep the design biased toward the simplest system that can satisfy the stated requirements.
-- Be explicit about tradeoffs, failure modes, and what should stay out of the first version.

package/skills/arch/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "$arch"
-  short_description: "Architecture-first product and system design"
-  default_prompt: "Use $arch to produce architecture, stack rationale, subsystem boundaries, tradeoffs, and a phased delivery plan."

package/skills/build/SKILL.md

@@ -1,24 +0,0 @@
----
-name: build
-description: "Use when the user wants to decide whether implementation is ready, what remains blocked, and what the exact next build step should be."
----
-
-# Build
-
-Use this skill inside Codex to convert the earlier review lanes into an implementation-ready decision.
-
-## Output
-
-Produce:
-- current readiness verdict
-- blockers that still prevent implementation
-- the narrowest viable build slice
-- branch or worktree suggestions when relevant
-- test and verification expectations
-- the exact next implementation step
-
-## Rules
-
-- Do not claim readiness if architecture, evidence, logic, security, or DX/UX gaps remain unresolved.
-- Keep the recommended build slice small, testable, and reversible.
-- If the user wants code immediately and the path is clear, end with a concrete implementation plan rather than more review prose.

package/skills/build/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "$build"
-  short_description: "Build-readiness decision and next implementation step"
-  default_prompt: "Use $build to decide whether implementation is ready, what remains blocked, and what the next build slice should be."

package/skills/flow/SKILL.md

@@ -1,24 +0,0 @@
----
-name: flow
-description: "Use when the user wants logic validation: states, transitions, invariants, edge cases, dead ends, and blockers before implementation."
----
-
-# Flow
-
-Use this skill inside Codex to pressure-test how the system behaves, not just how it is structured.
-
-## Output
-
-Produce:
-- key actors and system states
-- main flows and failure flows
-- invariants and state transitions
-- race conditions, dead ends, and consistency risks
-- missing requirements or ambiguous behavior
-- exact next trigger, usually `$vet`
-
-## Rules
-
-- Focus on behavior, not UI polish or low-level code details.
-- Surface ambiguity aggressively when it affects correctness.
-- Prefer simple state models over sprawling branching logic.

package/skills/flow/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "$flow"
-  short_description: "Logic, states, transitions, and blockers"
-  default_prompt: "Use $flow to map business logic, state transitions, invariants, and blockers in the current design."

package/skills/sage/SKILL.md

@@ -1,24 +0,0 @@
----
-name: sage
-description: "Use when the user wants evidence-backed technology choices, OSS evaluation, and source-grounded validation of the stack proposed in `$arch`."
----
-
-# Sage
-
-Use this skill inside Codex to verify or challenge stack choices with real sources.
-
-## Output
-
-Produce:
-- candidate tools, libraries, or services
-- why each option fits or fails the architecture
-- source-backed evidence from official docs, upstream repos, or approved GitMCP sources
-- recommendation with tradeoffs
-- unresolved gaps or missing evidence
-- exact next trigger, usually `$flow`
-
-## Rules
-
-- Do not invent package capabilities or maturity claims.
-- Prefer primary sources over summaries when validating technical details.
-- If the evidence is weak or contradictory, say so clearly and keep the recommendation conditional.

package/skills/sage/agents/openai.yaml

@@ -1,4 +0,0 @@
-interface:
-  display_name: "$sage"
-  short_description: "Evidence-backed stack and OSS validation"
-  default_prompt: "Use $sage to validate stack choices with official docs, upstream repos, and approved GitMCP-backed sources."