architectonic 0.0.1

package/README.md

@@ -0,0 +1,41 @@
+# architectonic
+
+`architectonic` is a command-line tool for installing and wiring the core layers of an agentic system.
+
+Those layers currently include:
+
+```text
+teleology  -- purpose, truth, evidence, governance
+identity   -- actors, roles, authority, privacy, constraints
+project    -- source-grounded project operating context
+skills     -- reusable procedures
+```
+
+The initial `0.0.1` release is intentionally minimal. Its job is to reserve the
+package name and establish the top-level command surface for future install,
+cascade, and upkeep workflows.
+
+## Planned direction
+
+Future versions may support commands such as:
+
+```text
+architectonic add teleology
+architectonic add identity
+architectonic add project
+architectonic add skills
+architectonic doctor
+architectonic update
+```
+
+## Current behavior
+
+For now, the CLI only exposes:
+
+```text
+npx architectonic
+npx architectonic help
+```
+
+The `add` surface is reserved, but the installer logic is not implemented in
+`0.0.1` yet.

package/bin/architectonic.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+const [command, target] = args;
+
+function printHelp() {
+  console.log(`architectonic 0.0.1
+
+CLI for installing and wiring the core layers of an agentic system.
+
+Usage:
+  npx architectonic
+  npx architectonic help
+  npx architectonic add <teleology|identity|project|skills>
+
+Status:
+  0.0.1 reserves the public CLI name and establishes the command surface.
+  The add subcommands are placeholders in this initial release.`);
+}
+
+if (!command || command === "help" || command === "--help" || command === "-h") {
+  printHelp();
+  process.exit(0);
+}
+
+if (command === "add") {
+  const supported = new Set(["teleology", "identity", "project", "skills"]);
+  if (!target || !supported.has(target)) {
+    console.error("Specify one of: teleology, identity, project, skills");
+    process.exit(1);
+  }
+
+  console.log(`architectonic add ${target}`);
+  console.log("");
+  console.log("This placeholder release does not install packages yet.");
+  console.log("It reserves the command contract for future cascade/install behavior.");
+  process.exit(0);
+}
+
+console.error(`Unknown command: ${command}`);
+console.error("Run `architectonic help` for usage.");
+process.exit(1);

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "architectonic",
+  "version": "0.0.1",
+  "description": "CLI for installing and wiring agentic system layers such as teleology, identity, project, and skills.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "architectonic": "bin/architectonic.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "keywords": [
+    "architectonic",
+    "agentic-systems",
+    "teleology",
+    "identity",
+    "project",
+    "skills",
+    "cli"
+  ]
+}