@timurproko/a1 0.1.8-dev.50ebb19 → 0.1.8-dev.510

package/dist/product-identity.js

@@ -0,0 +1,119 @@
+import rawIdentity from "./product-identity.json" with { type: "json" };
+const ENVIRONMENT_KEYS = [
+    "clipboardDiagnostics", "configDir", "dataDir", "databasePath", "developmentInstanceId", "developmentRoot", "endpoint",
+    "paneId", "probeTrace", "processGuardianPath", "profileHome", "runtimeDir", "startupTrace", "suggestionDiagnostics", "terminalSessionId",
+];
+const FILESYSTEM_KEYS = ["slug", "windowsDirectory", "unixDirectory", "temporaryPrefix"];
+const STATE_KEYS = ["windowsControlDirectory", "unixControlDirectory", "developmentDirectory", "piAgentProfile", "piVanillaProfile"];
+const ENDPOINT_KEYS = ["windowsPipeStem", "unixSocketFilename", "metadataFilename", "supervisorLogFilename", "databaseFilename"];
+const MANIFEST_KEYS = ["releaseFilename", "packageFilename"];
+const PROTOCOL_KEYS = ["namespace", "controlEnvelope", "supervisorSchema", "nativeHostSchema", "structuredAgentSchema", "controlStoreSchema", "promptHistorySchema", "releaseCohortSchema", "updateJournalSchema"];
+const EVIDENCE_KEYS = ["nativeSpikeSchema", "terminalProvenanceSchema", "terminalProofSchema", "stableReleaseSchema", "previewReleaseSchema", "releaseCertificationSchema", "previewPlatformVerdictSchema", "piSourceLedgerSchema", "piComponentParitySchema", "piEventFrameParitySchema", "startupTraceSchema", "dependencyLayerSchema", "dependencyLayerCertificationSchema", "runtimePayloadSchema"];
+const ARTIFACT_KEYS = ["cliEntry", "supervisorEntry", "guardianEntry", "uiEntry", "nativeExecutable", "nativeCrate", "processGuardianExecutable", "releaseTarballStem", "diagnosticStem"];
+const ROOT_KEYS = ["schema", "displayName", "commandName", "packageName", "filesystem", "environment", "state", "endpoint", "manifest", "protocol", "evidence", "artifacts"];
+export function validateProductIdentity(value) {
+    const root = exactObject(value, ROOT_KEYS, "product identity");
+    const schema = stringValue(root.schema, "product identity schema");
+    const displayName = stringValue(root.displayName, "product display name");
+    const commandName = stringValue(root.commandName, "product command name");
+    const packageName = stringValue(root.packageName, "product package name");
+    const filesystem = stringObject(root.filesystem, FILESYSTEM_KEYS, "filesystem identity");
+    const environment = stringObject(root.environment, ENVIRONMENT_KEYS, "environment identity");
+    const state = stringObject(root.state, STATE_KEYS, "state identity");
+    const endpoint = stringObject(root.endpoint, ENDPOINT_KEYS, "endpoint identity");
+    const manifest = stringObject(root.manifest, MANIFEST_KEYS, "manifest identity");
+    const protocol = stringObject(root.protocol, PROTOCOL_KEYS, "protocol identity");
+    const evidence = stringObject(root.evidence, EVIDENCE_KEYS, "evidence identity");
+    const artifacts = stringObject(root.artifacts, ARTIFACT_KEYS, "artifact identity");
+    if (!/^[a-z][a-z0-9-]*$/.test(commandName))
+        throw new TypeError("product command name must be a lowercase command slug");
+    if (!/^@[a-z0-9-]+\/[a-z0-9-]+$/.test(packageName))
+        throw new TypeError("product package name must be a lowercase scoped npm package");
+    if (displayName.trim() !== displayName || displayName.length === 0)
+        throw new TypeError("product display name must be non-empty without surrounding whitespace");
+    if (schema !== `${commandName}-product-identity-v1`)
+        throw new TypeError("product identity schema must derive from the command name");
+    if (filesystem.slug !== commandName || filesystem.unixDirectory !== filesystem.slug || filesystem.windowsDirectory !== filesystem.slug) {
+        throw new TypeError("product filesystem identity must derive from the command name");
+    }
+    if (filesystem.temporaryPrefix !== `${filesystem.slug}-`)
+        throw new TypeError("product temporary prefix must derive from the filesystem slug");
+    if (state.windowsControlDirectory !== filesystem.windowsDirectory || state.unixControlDirectory !== filesystem.unixDirectory) {
+        throw new TypeError("product state directories must match the filesystem identity");
+    }
+    if (endpoint.windowsPipeStem !== filesystem.slug)
+        throw new TypeError("product endpoint stem must match the filesystem slug");
+    if (protocol.namespace !== commandName)
+        throw new TypeError("product protocol namespace must match the command name");
+    if (artifacts.diagnosticStem !== filesystem.slug)
+        throw new TypeError("product diagnostic stem must match the filesystem slug");
+    const environmentPrefix = `${commandName.toUpperCase()}_`;
+    const environmentValues = Object.values(environment);
+    if (new Set(environmentValues).size !== environmentValues.length)
+        throw new TypeError("product environment keys must be unique");
+    for (const key of environmentValues) {
+        if (!key.startsWith(environmentPrefix) || !/^[A-Z][A-Z0-9_]+$/.test(key)) {
+            throw new TypeError(`product environment key must use ${environmentPrefix}: ${key}`);
+        }
+    }
+    for (const [name, identifier] of Object.entries(protocol)) {
+        if (name !== "namespace" && !identifier.startsWith(`${protocol.namespace}-`)) {
+            throw new TypeError(`product protocol identifier must use ${protocol.namespace}: ${identifier}`);
+        }
+    }
+    for (const identifier of Object.values(evidence)) {
+        if (!identifier.startsWith(`${protocol.namespace}-`))
+            throw new TypeError(`product evidence identifier must use ${protocol.namespace}: ${identifier}`);
+    }
+    return deepFreeze({
+        schema,
+        displayName,
+        commandName,
+        packageName,
+        filesystem,
+        environment,
+        state,
+        endpoint,
+        manifest,
+        protocol,
+        evidence,
+        artifacts,
+    });
+}
+export function createProductIdentityText(identity) {
+    return Object.freeze({
+        displayName: identity.displayName,
+        commandName: identity.commandName,
+        packageName: identity.packageName,
+        diagnostic: (message) => `${identity.displayName} ${message}`,
+        usage: (forms) => `Usage: ${forms.map(form => `${identity.commandName}${form ? ` ${form}` : ""}`).join(" | ")}`,
+    });
+}
+export const PRODUCT_IDENTITY = validateProductIdentity(rawIdentity);
+export const PRODUCT_TEXT = createProductIdentityText(PRODUCT_IDENTITY);
+function exactObject(value, keys, name) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new TypeError(`${name} must be an object`);
+    const actualKeys = Object.keys(value).sort();
+    const expectedKeys = [...keys].sort();
+    if (actualKeys.length !== expectedKeys.length || actualKeys.some((key, index) => key !== expectedKeys[index])) {
+        throw new TypeError(`${name} must contain exactly: ${expectedKeys.join(", ")}`);
+    }
+    return value;
+}
+function stringObject(value, keys, name) {
+    const object = exactObject(value, keys, name);
+    return Object.fromEntries(keys.map((key) => [key, stringValue(object[key], `${name}.${key}`)]));
+}
+function stringValue(value, name) {
+    if (typeof value !== "string" || value.length === 0)
+        throw new TypeError(`${name} must be a non-empty string`);
+    return value;
+}
+function deepFreeze(value) {
+    if (typeof value !== "object" || value === null || Object.isFrozen(value))
+        return value;
+    for (const child of Object.values(value))
+        deepFreeze(child);
+    return Object.freeze(value);
+}

package/dist/product-identity.json

@@ -0,0 +1,85 @@
+{
+    "schema": "a1-product-identity-v1",
+    "displayName": "a1",
+    "commandName": "a1",
+    "packageName": "@timurproko/a1",
+    "filesystem": {
+        "slug": "a1",
+        "windowsDirectory": "a1",
+        "unixDirectory": "a1",
+        "temporaryPrefix": "a1-"
+    },
+    "environment": {
+        "clipboardDiagnostics": "A1_CLIPBOARD_DIAGNOSTICS",
+        "configDir": "A1_CONFIG_DIR",
+        "dataDir": "A1_DATA_DIR",
+        "databasePath": "A1_DATABASE_PATH",
+        "developmentInstanceId": "A1_DEV_INSTANCE_ID",
+        "developmentRoot": "A1_DEV_ROOT",
+        "endpoint": "A1_ENDPOINT",
+        "paneId": "A1_PANE_ID",
+        "probeTrace": "A1_PROBE_TRACE",
+        "processGuardianPath": "A1_PROCESS_GUARDIAN_PATH",
+        "profileHome": "A1_PROFILE_HOME",
+        "runtimeDir": "A1_RUNTIME_DIR",
+        "startupTrace": "A1_STARTUP_TRACE",
+        "suggestionDiagnostics": "A1_SUGGESTION_DIAGNOSTICS",
+        "terminalSessionId": "A1_TERMINAL_SESSION_ID"
+    },
+    "state": {
+        "windowsControlDirectory": "a1",
+        "unixControlDirectory": "a1",
+        "developmentDirectory": "a1-development",
+        "piAgentProfile": ".a1/agent",
+        "piVanillaProfile": ".pi/agent"
+    },
+    "endpoint": {
+        "windowsPipeStem": "a1",
+        "unixSocketFilename": "supervisor.sock",
+        "metadataFilename": "supervisor.json",
+        "supervisorLogFilename": "supervisor.log",
+        "databaseFilename": "control.sqlite3"
+    },
+    "manifest": {
+        "releaseFilename": ".a1-release.json",
+        "packageFilename": "package.json"
+    },
+    "protocol": {
+        "namespace": "a1",
+        "controlEnvelope": "a1-control-envelope",
+        "supervisorSchema": "a1-supervisor-v1",
+        "nativeHostSchema": "a1-native-host-v1",
+        "structuredAgentSchema": "a1-structured-agent-v1",
+        "controlStoreSchema": "a1-control-store-v1",
+        "promptHistorySchema": "a1-prompt-history-v1",
+        "releaseCohortSchema": "a1-release-cohort-v1",
+        "updateJournalSchema": "a1-update-journal-v1"
+    },
+    "evidence": {
+        "nativeSpikeSchema": "a1-native-host-spike-evidence-v1",
+        "terminalProvenanceSchema": "a1-terminal-host-provenance-v1",
+        "terminalProofSchema": "a1-terminal-host-proof-v1",
+        "stableReleaseSchema": "a1-stable-release-v1",
+        "previewReleaseSchema": "a1-preview-release-v1",
+        "releaseCertificationSchema": "a1-release-certification-v1",
+        "previewPlatformVerdictSchema": "a1-development-preview-platform-verdict-v2",
+        "piSourceLedgerSchema": "a1-pinned-pi-source-port-ledger-v1",
+        "piComponentParitySchema": "a1-pi-static-component-parity-v1",
+        "piEventFrameParitySchema": "a1-pi-event-frame-parity-v1",
+        "startupTraceSchema": "a1-startup-trace-v1",
+        "dependencyLayerSchema": "a1-dependency-layer-v1",
+        "dependencyLayerCertificationSchema": "a1-dependency-layer-certification-v1",
+        "runtimePayloadSchema": "a1-runtime-payload-v1"
+    },
+    "artifacts": {
+        "cliEntry": "bin/cli.js",
+        "supervisorEntry": "bin/supervisor.js",
+        "guardianEntry": "bin/guardian.js",
+        "uiEntry": "bin/ui.js",
+        "nativeExecutable": "terminal-host",
+        "nativeCrate": "terminal-host",
+        "processGuardianExecutable": "process-guardian",
+        "releaseTarballStem": "timurproko-a1",
+        "diagnosticStem": "a1"
+    }
+}