@justfortytwo/installer 0.1.0

package/dist/state.js

@@ -0,0 +1,93 @@
+// state.ts — persistence for the two gitignored files under `.fortytwo/`.
+//
+// `.fortytwo/identity.json`  — captured answers from `init` (agent name, owner
+//   details, channel bindings). This is the SOURCE OF TRUTH the persona
+//   renderer (render.ts) reads to materialize `context/*`. It is gitignored: it
+//   holds personal data and must never be versioned. Re-running `init` or
+//   `enrich` mutates it; `render` only READS it.
+//
+// `.fortytwo/state.json`     — the installed version set (the resolved sibling
+//   package versions at the last successful `update`/`init`). This is the
+//   rollback ledger: before each update we snapshot the current set into
+//   `previous` so `rollback` can restore it. Distribution policy is
+//   "semver ranges, latest-compatible" — there is NO curated bill-of-materials,
+//   so the only record of "what worked" is what we capture HERE at install time.
+//
+// Both files live under the project root's `.fortytwo/` dir. Neither is created
+// until `init` runs. Reads of a missing file return `null` (callers decide if
+// that's fatal) rather than throwing — except where a command explicitly
+// requires prior init (e.g. rollback needs state.json).
+import { readFileSync, writeFileSync, mkdirSync, existsSync, renameSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+export const FORTYTWO_DIR = '.fortytwo';
+export const IDENTITY_FILE = 'identity.json';
+export const STATE_FILE = 'state.json';
+function fortytwoPath(root, file) {
+    return join(resolve(root), FORTYTWO_DIR, file);
+}
+function readJson(path) {
+    // TODO(impl): return null when the file is absent; throw on malformed JSON
+    // (a corrupt state file is a real error the user must see, not silently eat).
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+function writeJson(path, value) {
+    // Atomic write: a crash mid-write must not truncate the rollback ledger.
+    // Write to a temp file in the SAME dir (so rename stays on one filesystem),
+    // then rename — rename is atomic on POSIX.
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp`;
+    writeFileSync(tmp, JSON.stringify(value, null, 2) + '\n', 'utf8');
+    renameSync(tmp, path);
+}
+// --- identity.json ---
+export function readIdentity(root = process.cwd()) {
+    return readJson(fortytwoPath(root, IDENTITY_FILE));
+}
+export function writeIdentity(identity, root = process.cwd()) {
+    const existing = readIdentity(root);
+    const now = new Date().toISOString();
+    writeJson(fortytwoPath(root, IDENTITY_FILE), {
+        ...identity,
+        createdAt: existing?.createdAt ?? identity.createdAt ?? now,
+        updatedAt: now,
+    });
+}
+// --- state.json ---
+export function readState(root = process.cwd()) {
+    return readJson(fortytwoPath(root, STATE_FILE));
+}
+export function writeState(state, root = process.cwd()) {
+    writeJson(fortytwoPath(root, STATE_FILE), state);
+}
+/**
+ * Record a freshly-resolved version set, rotating the existing `current` into
+ * `previous` so `rollback` has a target. Called by `update` (and `init`).
+ * TODO(impl): on the very first install, `previous` stays null.
+ */
+function samePins(a, b) {
+    if (!a || a.length !== b.length)
+        return false;
+    return a.every((p, i) => {
+        const q = b[i];
+        return !!q && p.name === q.name && p.resolved === q.resolved && p.range === q.range;
+    });
+}
+export function recordVersionSet(next, root = process.cwd()) {
+    const prior = readState(root);
+    // Don't burn the rollback target by re-recording an identical set (e.g.
+    // re-running `update` with the same resolves) — keep `previous` pointing at the
+    // last set that actually DIFFERED. NOTE: rollback is single-step: `previous`
+    // holds only the immediately-prior set, not a full history.
+    const previous = prior ? (samePins(prior.current, next) ? prior.previous : prior.current) : null;
+    const state = {
+        stateVersion: 1,
+        current: next,
+        previous,
+        lastUpdatedAt: new Date().toISOString(),
+    };
+    writeState(state, root);
+    return state;
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@justfortytwo/installer",
+  "version": "0.1.0",
+  "description": "All-in-one installer and lifecycle CLI for fortytwo — scaffolds the persona surface and provisions the npm engine (memory MCP, safety gate, channel adapters, embedder).",
+  "license": "MIT",
+  "author": {
+    "name": "Enrico Deleo",
+    "url": "https://enricodeleo.com"
+  },
+  "homepage": "https://forty-two.it",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justfortytwo/installer.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "create-fortytwo": "dist/index.js",
+    "fortytwo": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "justfortytwo",
+    "fortytwo",
+    "claude-code",
+    "personal-assistant",
+    "cli",
+    "installer"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0",
+    "vitest": "^2.1.0"
+  },
+  "peerDependencies": {
+    "@justfortytwo/memory": "^0.1.0",
+    "@justfortytwo/gate": "^0.1.0",
+    "@justfortytwo/persona": "^0.1.0",
+    "@justfortytwo/telegram": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@justfortytwo/memory": {
+      "optional": true
+    },
+    "@justfortytwo/gate": {
+      "optional": true
+    },
+    "@justfortytwo/persona": {
+      "optional": true
+    },
+    "@justfortytwo/telegram": {
+      "optional": true
+    }
+  },
+  "fortytwo": {
+    "comment": "Compatibility contract this CLI version was authored against. doctor cross-checks the *installed* sibling packages against these ranges; update/rollback record the resolved set into .fortytwo/state.json. TODO(wire): bump these as sibling contracts evolve.",
+    "compat": {
+      "@justfortytwo/memory": "^0.1.0",
+      "@justfortytwo/gate": "^0.1.0",
+      "@justfortytwo/persona": "^0.1.0",
+      "@justfortytwo/telegram": "^0.1.0"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}