@morphism-systems/cli 0.1.0

package/README.md

@@ -0,0 +1,26 @@
+# @morphism-systems/cli
+
+Morphism governance CLI. Initialize config, validate governance, check maturity scores, run health checks.
+
+## Install
+
+```bash
+npm install -g @morphism-systems/cli
+```
+
+## Usage
+
+```bash
+morphism init        # Initialize .morphism/ config
+morphism validate    # Run governance validation
+morphism score       # Compute maturity score
+morphism doctor      # Health check
+```
+
+## Why Morphism
+
+Governance-as-code with mathematical guarantees. [Learn more](https://morphism.systems).
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/index.js

@@ -0,0 +1,635 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/init.ts
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+var DEFAULT_CONFIG = {
+  version: "0.1.0",
+  governance: {
+    kernel: "morphism-kernel",
+    invariants: 7,
+    tenets: 10
+  },
+  metrics: {
+    convergence_threshold: 1,
+    drift_threshold: 15
+  }
+};
+function init(cwd) {
+  const morphismDir = join(cwd, ".morphism");
+  if (existsSync(morphismDir)) {
+    console.log(".morphism/ already exists \u2014 skipping");
+    return;
+  }
+  mkdirSync(morphismDir, { recursive: true });
+  writeFileSync(
+    join(morphismDir, "config.json"),
+    JSON.stringify(DEFAULT_CONFIG, null, 2) + "\n"
+  );
+  console.log("Initialized .morphism/ with default config");
+}
+
+// src/commands/validate.ts
+import { execSync } from "child_process";
+function validate(cwd) {
+  try {
+    const result = execSync("python3 scripts/verify_pipeline.py", {
+      cwd,
+      encoding: "utf-8",
+      timeout: 3e4
+    });
+    console.log(result);
+    console.log("Governance validation: PASS");
+  } catch (err) {
+    const error = err;
+    if (error.stdout) console.log(error.stdout);
+    if (error.stderr) console.error(error.stderr);
+    console.error("Governance validation: FAIL");
+    process.exit(1);
+  }
+}
+
+// src/commands/score.ts
+import { execSync as execSync2 } from "child_process";
+function score(cwd, threshold) {
+  try {
+    const result = execSync2(
+      `python3 scripts/maturity_score.py --ci --threshold ${threshold}`,
+      { cwd, encoding: "utf-8", timeout: 3e4 }
+    );
+    console.log(result);
+  } catch (err) {
+    const error = err;
+    if (error.stdout) console.log(error.stdout);
+    if (error.stderr) console.error(error.stderr);
+    process.exit(1);
+  }
+}
+
+// src/commands/doctor.ts
+import { existsSync as existsSync2 } from "fs";
+import { join as join2 } from "path";
+import { execSync as execSync3 } from "child_process";
+function doctor(cwd) {
+  const checks = [
+    {
+      name: ".morphism/ config exists",
+      test: () => existsSync2(join2(cwd, ".morphism", "config.json"))
+    },
+    {
+      name: "AGENTS.md exists",
+      test: () => existsSync2(join2(cwd, "AGENTS.md"))
+    },
+    {
+      name: "SSOT.md exists",
+      test: () => existsSync2(join2(cwd, "SSOT.md"))
+    },
+    {
+      name: "Python available",
+      test: () => {
+        try {
+          execSync3("python3 --version", { encoding: "utf-8", timeout: 5e3 });
+          return true;
+        } catch {
+          return false;
+        }
+      }
+    },
+    {
+      name: "Governance scripts exist",
+      test: () => existsSync2(join2(cwd, "scripts", "verify_pipeline.py"))
+    }
+  ];
+  let allPassed = true;
+  for (const check of checks) {
+    const passed = check.test();
+    const icon = passed ? "+" : "-";
+    console.log(`  [${icon}] ${check.name}`);
+    if (!passed) allPassed = false;
+  }
+  if (allPassed) {
+    console.log("\nAll checks passed");
+  } else {
+    console.log("\nSome checks failed \u2014 run `morphism init` to set up");
+    process.exit(1);
+  }
+}
+
+// src/commands/scaffold.ts
+import { mkdirSync as mkdirSync2, writeFileSync as writeFileSync2, existsSync as existsSync3 } from "fs";
+import { join as join3, dirname } from "path";
+function writeFiles(cwd, files) {
+  let created = 0;
+  for (const [relPath, content] of Object.entries(files)) {
+    const fullPath = join3(cwd, relPath);
+    if (existsSync3(fullPath)) {
+      console.log(`  skip: ${relPath} (already exists)`);
+      continue;
+    }
+    mkdirSync2(dirname(fullPath), { recursive: true });
+    writeFileSync2(fullPath, content);
+    console.log(`  created: ${relPath}`);
+    created++;
+  }
+  return created;
+}
+function governanceFiles() {
+  return {
+    "AGENTS.md": `# Agents
+
+## Governance
+
+This project follows the Morphism governance framework.
+
+## Invariants
+
+7 normative invariants (I-1 through I-7) from the morphism kernel.
+
+## Scope
+
+See .morphism/config.json for governance configuration.
+`,
+    "SSOT.md": `# SSOT
+
+## Canonical Sources
+
+| Domain | Source |
+|--------|--------|
+| Governance | .morphism/config.json |
+| Agents | AGENTS.md |
+| Guidelines | GUIDELINES.md |
+`,
+    "GUIDELINES.md": `# Guidelines
+
+## Commit Messages
+
+Use conventional commits: \`type(scope): subject\`
+
+Types: feat, fix, chore, ci, docs, refactor, test, perf, hotfix
+
+## Code Style
+
+- TypeScript: strict mode, ESM
+- Lint before commit
+- Tests required for new features
+`,
+    ".morphism/config.json": JSON.stringify(
+      {
+        version: "0.1.0",
+        governance: { kernel: "morphism-kernel", invariants: 7, tenets: 10 },
+        metrics: { convergence_threshold: 1, drift_threshold: 15 }
+      },
+      null,
+      2
+    ) + "\n"
+  };
+}
+function monorepoFiles(name) {
+  return {
+    // Root config
+    "package.json": JSON.stringify(
+      {
+        name,
+        private: true,
+        workspaces: [`apps/*`, `packages/*`],
+        scripts: {
+          build: "turbo build",
+          dev: "turbo dev",
+          lint: "turbo lint",
+          typecheck: "turbo typecheck",
+          test: "turbo test"
+        },
+        devDependencies: {
+          turbo: "^2.0.0",
+          typescript: "^5.8.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "turbo.json": JSON.stringify(
+      {
+        $schema: "https://turbo.build/schema.json",
+        tasks: {
+          build: { dependsOn: ["^build"], outputs: ["dist/**", ".next/**"] },
+          dev: { cache: false, persistent: true },
+          lint: { dependsOn: ["^build"] },
+          typecheck: { dependsOn: ["^build"] },
+          test: { dependsOn: ["build"] }
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "tsconfig.json": JSON.stringify(
+      {
+        compilerOptions: {
+          target: "ES2022",
+          module: "ESNext",
+          moduleResolution: "bundler",
+          strict: true,
+          esModuleInterop: true,
+          skipLibCheck: true,
+          declaration: true,
+          resolveJsonModule: true
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    ".gitignore": `node_modules/
+dist/
+.next/
+.turbo/
+*.tsbuildinfo
+.env
+.env.local
+`,
+    // Governance
+    ...governanceFiles(),
+    // App stub
+    [`apps/${name}/package.json`]: JSON.stringify(
+      {
+        name: `@${name}/app`,
+        version: "0.1.0",
+        private: true,
+        scripts: {
+          dev: "next dev",
+          build: "next build",
+          start: "next start",
+          lint: "next lint",
+          typecheck: "tsc --noEmit"
+        },
+        dependencies: {
+          next: "^15.0.0",
+          react: "^19.0.0",
+          "react-dom": "^19.0.0",
+          [`@${name}/shared`]: "workspace:*"
+        },
+        devDependencies: {
+          typescript: "^5.8.0",
+          "@types/react": "^19.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    [`apps/${name}/tsconfig.json`]: JSON.stringify(
+      {
+        extends: "../../tsconfig.json",
+        compilerOptions: {
+          jsx: "preserve",
+          outDir: "dist",
+          rootDir: "src",
+          plugins: [{ name: "next" }]
+        },
+        include: ["src", "next-env.d.ts"],
+        exclude: ["node_modules", "dist", ".next"]
+      },
+      null,
+      2
+    ) + "\n",
+    [`apps/${name}/src/app/layout.tsx`]: `export const metadata = {
+  title: '${name}',
+  description: 'A Morphism-governed application',
+}
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>{children}</body>
+    </html>
+  )
+}
+`,
+    [`apps/${name}/src/app/page.tsx`]: `export default function Home() {
+  return (
+    <main>
+      <h1>${name}</h1>
+      <p>Scaffolded with Morphism governance.</p>
+    </main>
+  )
+}
+`,
+    // Shared package stub
+    "packages/shared/package.json": JSON.stringify(
+      {
+        name: `@${name}/shared`,
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        main: "dist/index.js",
+        types: "dist/index.d.ts",
+        scripts: {
+          build: "tsup src/index.ts --format esm --dts --clean",
+          typecheck: "tsc --noEmit",
+          test: "vitest run"
+        },
+        devDependencies: {
+          tsup: "^8.0.0",
+          typescript: "^5.8.0",
+          vitest: "^3.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    "packages/shared/tsconfig.json": JSON.stringify(
+      {
+        extends: "../../tsconfig.json",
+        compilerOptions: {
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"],
+        exclude: ["node_modules", "dist"]
+      },
+      null,
+      2
+    ) + "\n",
+    "packages/shared/src/index.ts": `/**
+ * @${name}/shared \u2014 shared utilities
+ */
+export function greeting(name: string): string {
+  return \`Hello from \${name}!\`
+}
+`,
+    "packages/shared/__tests__/index.test.ts": `import { describe, it, expect } from 'vitest'
+import { greeting } from '../src/index.js'
+
+describe('shared', () => {
+  it('returns a greeting', () => {
+    expect(greeting('world')).toBe('Hello from world!')
+  })
+})
+`,
+    // Scripts
+    "scripts/verify_pipeline.py": `#!/usr/bin/env python3
+"""Basic governance verification pipeline."""
+
+import sys
+from pathlib import Path
+
+
+def main() -> int:
+    root = Path(__file__).resolve().parent.parent
+    checks = [
+        ("AGENTS.md", root / "AGENTS.md"),
+        ("SSOT.md", root / "SSOT.md"),
+        ("GUIDELINES.md", root / "GUIDELINES.md"),
+        (".morphism/config.json", root / ".morphism" / "config.json"),
+    ]
+    failed = 0
+    for label, path in checks:
+        if path.exists():
+            print(f"  [+] {label}")
+        else:
+            print(f"  [-] {label} MISSING")
+            failed += 1
+    if failed:
+        print(f"\\n{failed} check(s) failed")
+        return 1
+    print("\\nAll checks passed")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())
+`,
+    // Docs
+    "docs/README.md": `# Documentation
+
+This directory contains project documentation.
+
+## Structure
+
+- \`adr/\` \u2014 Architecture Decision Records
+- \`governance/\` \u2014 Governance framework docs
+- \`runbooks/\` \u2014 Operational runbooks
+`,
+    "docs/adr/000-template.md": `# ADR-000: Template
+
+## Status
+
+Accepted
+
+## Context
+
+Template for Architecture Decision Records.
+
+## Decision
+
+Use this format for all ADRs.
+
+## Consequences
+
+Consistent decision documentation.
+`,
+    // CI
+    ".github/workflows/ci.yml": `name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+      - run: npm ci
+      - run: npx turbo build
+      - run: npx turbo typecheck
+      - run: npx turbo lint
+      - run: npx turbo test
+`
+  };
+}
+function packageFiles(name) {
+  return {
+    [`packages/${name}/package.json`]: JSON.stringify(
+      {
+        name: `@morphism-systems/${name}`,
+        version: "0.1.0",
+        type: "module",
+        main: "dist/index.js",
+        types: "dist/index.d.ts",
+        scripts: {
+          build: "tsup src/index.ts --format esm --dts --clean",
+          typecheck: "tsc --noEmit",
+          test: "vitest run",
+          lint: 'echo "no lint configured"'
+        },
+        devDependencies: {
+          tsup: "^8.0.0",
+          typescript: "^5.8.0",
+          vitest: "^3.0.0"
+        }
+      },
+      null,
+      2
+    ) + "\n",
+    [`packages/${name}/tsconfig.json`]: JSON.stringify(
+      {
+        extends: "../../tsconfig.json",
+        compilerOptions: {
+          outDir: "dist",
+          rootDir: "src"
+        },
+        include: ["src"],
+        exclude: ["node_modules", "dist"]
+      },
+      null,
+      2
+    ) + "\n",
+    [`packages/${name}/src/index.ts`]: `/**
+ * @morphism-systems/${name}
+ */
+export function hello(): string {
+  return 'Hello from @morphism-systems/${name}!'
+}
+`,
+    [`packages/${name}/__tests__/index.test.ts`]: `import { describe, it, expect } from 'vitest'
+import { hello } from '../src/index.js'
+
+describe('${name}', () => {
+  it('exports hello', () => {
+    expect(hello()).toContain('${name}')
+  })
+})
+`
+  };
+}
+var LEGACY_TEMPLATES = {
+  "ts-project": () => ({
+    ...governanceFiles(),
+    ".githooks/commit-msg": '#!/usr/bin/env bash\n# Validate commit message format: type(scope): subject\nMSG=$(head -1 "$1")\nif ! echo "$MSG" | grep -qE "^(feat|fix|chore|ci|docs|refactor|test|perf|hotfix)\\([^)]+\\): .+"; then\n  echo "Invalid commit message format. Use: type(scope): subject"\n  exit 1\nfi\n'
+  }),
+  "py-project": () => ({
+    ...governanceFiles(),
+    "pyproject.toml": '[tool.ruff]\nline-length = 100\n\n[tool.ruff.lint]\nselect = ["E", "F", "I", "N", "UP", "B", "SIM"]\n\n[tool.mypy]\nstrict = true\n'
+  })
+};
+function scaffold(cwd, template) {
+  const templateFn = LEGACY_TEMPLATES[template];
+  if (!templateFn) {
+    const available = [
+      ...Object.keys(LEGACY_TEMPLATES),
+      "monorepo <name>",
+      "package <name>",
+      "governance"
+    ].join(", ");
+    console.error(`Unknown template: ${template}. Available: ${available}`);
+    process.exit(1);
+  }
+  const files = templateFn();
+  const created = writeFiles(cwd, files);
+  console.log(`
+Scaffolded ${created} file(s) using '${template}' template`);
+}
+function scaffoldMonorepo(cwd, name) {
+  console.log(`Scaffolding monorepo '${name}'...`);
+  const targetDir = join3(cwd, name);
+  mkdirSync2(targetDir, { recursive: true });
+  const files = monorepoFiles(name);
+  const created = writeFiles(targetDir, files);
+  console.log(`
+Scaffolded monorepo '${name}' with ${created} file(s) in ${name}/`);
+}
+function scaffoldPackage(cwd, name) {
+  console.log(`Scaffolding package '${name}'...`);
+  const files = packageFiles(name);
+  const created = writeFiles(cwd, files);
+  console.log(`
+Scaffolded package '${name}' with ${created} file(s)`);
+}
+function scaffoldGovernance(cwd) {
+  console.log("Scaffolding governance files...");
+  const files = {
+    ...governanceFiles(),
+    // CI workflow for governance checks
+    ".github/workflows/governance.yml": `name: Governance
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  governance:
+    name: Governance checks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+      - name: Install morphism
+        run: pip install morphism-systems
+      - name: Maturity score
+        run: python3 scripts/maturity_score.py --ci --threshold 60
+      - name: Verify pipeline
+        run: python3 scripts/verify_pipeline.py
+`,
+    // Pre-commit hook
+    ".githooks/pre-commit": `#!/usr/bin/env bash
+# Morphism governance pre-commit hook
+set -e
+
+# Run policy check if available
+if [ -f scripts/policy_check.py ]; then
+  python3 scripts/policy_check.py --mode ci --explain || {
+    echo "Policy check failed. Fix issues before committing."
+    exit 1
+  }
+fi
+
+# Run lint on staged files
+STAGED_PY=$(git diff --cached --name-only --diff-filter=ACM | grep '\\.py$' || true)
+if [ -n "$STAGED_PY" ]; then
+  echo "Checking Python files..."
+  ruff check $STAGED_PY 2>/dev/null || true
+fi
+`,
+    // Commit message hook
+    ".githooks/commit-msg": `#!/usr/bin/env bash
+# Validate commit message: type(scope): subject
+MSG=$(head -1 "$1")
+if ! echo "$MSG" | grep -qE "^(feat|fix|chore|ci|docs|refactor|test|perf|hotfix)\\([^)]+\\): .+"; then
+  echo "Invalid commit message format. Use: type(scope): subject"
+  exit 1
+fi
+`
+  };
+  const created = writeFiles(cwd, files);
+  console.log(`
+Scaffolded ${created} governance file(s)`);
+  console.log("\nNext steps:");
+  console.log("  1. Run: git config core.hooksPath .githooks");
+  console.log("  2. Review AGENTS.md and customize invariants");
+  console.log("  3. Push to trigger governance CI checks");
+}
+
+// src/index.ts
+var program = new Command();
+program.name("morphism").description("Morphism governance CLI").version("0.1.0");
+program.command("init").description("Initialize .morphism/ config in the current project").action(() => init(process.cwd()));
+program.command("validate").description("Run the governance validation pipeline").action(() => validate(process.cwd()));
+program.command("score").description("Compute the governance maturity score").option("-t, --threshold <n>", "Minimum passing score", "60").action((opts) => score(process.cwd(), parseInt(opts.threshold)));
+program.command("doctor").description("Health check \u2014 verify governance setup").action(() => doctor(process.cwd()));
+var scaffoldCmd = program.command("scaffold").description("Scaffold projects, packages, and governance files");
+scaffoldCmd.command("monorepo <name>").description("Generate a full Morphism-governed monorepo").action((name) => scaffoldMonorepo(process.cwd(), name));
+scaffoldCmd.command("package <name>").description("Add a new package to an existing monorepo").action((name) => scaffoldPackage(process.cwd(), name));
+scaffoldCmd.command("governance").description("Add governance files (AGENTS.md, SSOT.md, GUIDELINES.md, .morphism/) to an existing project").action(() => scaffoldGovernance(process.cwd()));
+scaffoldCmd.command("legacy <template>").description("Legacy scaffold templates (ts-project, py-project)").action((template) => scaffold(process.cwd(), template));
+program.parse();

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@morphism-systems/cli",
+  "version": "0.1.0",
+  "description": "Morphism governance CLI — init, validate, score, doctor",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "morphism": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts --clean",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "echo 'no lint configured'"
+  },
+  "keywords": [
+    "morphism",
+    "governance",
+    "cli",
+    "ai-governance",
+    "category-theory"
+  ],
+  "license": "BUSL-1.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "commander": "^13.1.0",
+    "chalk": "^5.4.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.3",
+    "vitest": "^3.0.0"
+  }
+}