architectonic 0.0.1 → 0.0.2

package/README.md

@@ -1,33 +1,38 @@
 # architectonic
 
-`architectonic` is a command-line tool for installing and wiring the core layers of an agentic system.
+`architectonic` is a command-line tool for composing 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
+teleology  -- purpose, principles, doctrine, governance
+identity   -- actors, roles, authority, boundaries
+project    -- operating context for a concrete initiative
+skills     -- reusable procedures and capabilities
 ```
 
-The initial `0.0.1` release is intentionally minimal. Its job is to reserve the
+The initial placeholder releases are intentionally minimal. Their job is to reserve the
 package name and establish the top-level command surface for future install,
 cascade, and upkeep workflows.
 
-## Planned direction
+## Command shape
 
-Future versions may support commands such as:
+The primary interaction model is:
 
 ```text
 architectonic add teleology
 architectonic add identity
 architectonic add project
 architectonic add skills
+architectonic add teleology identity skills
 architectonic doctor
+architectonic list
 architectonic update
 ```
 
+`add` is explicit and leaves room for future verbs such as `doctor`, `list`,
+`update`, and `remove`.
+
 ## Current behavior
 
 For now, the CLI only exposes:
@@ -35,7 +40,16 @@ For now, the CLI only exposes:
 ```text
 npx architectonic
 npx architectonic help
+npx architectonic add <layer>
 ```
 
 The `add` surface is reserved, but the installer logic is not implemented in
-`0.0.1` yet.
+`0.0.2` yet.
+
+## Run vs install
+
+```text
+npx architectonic ...        # run immediately
+npm install architectonic    # install as a dependency
+npm install -g architectonic # install globally, then run `architectonic ...`
+```

package/bin/architectonic.js

@@ -1,20 +1,34 @@
 #!/usr/bin/env node
 
 const args = process.argv.slice(2);
-const [command, target] = args;
+const [command, ...targets] = args;
+const supported = ["teleology", "identity", "project", "skills"];
+const supportedSet = new Set(supported);
 
 function printHelp() {
-  console.log(`architectonic 0.0.1
+  console.log(`architectonic 0.0.2
 
-CLI for installing and wiring the core layers of an agentic system.
+CLI for composing the core layers of an agentic system.
 
 Usage:
   npx architectonic
   npx architectonic help
   npx architectonic add <teleology|identity|project|skills>
+  npx architectonic add teleology identity skills
+
+Layers:
+  teleology  purpose, principles, doctrine, governance
+  identity   actors, roles, authority, boundaries
+  project    operating context for a concrete initiative
+  skills     reusable procedures and capabilities
+
+Run vs install:
+  npx architectonic ...        run immediately
+  npm install architectonic    install in a project
+  npm install -g architectonic install globally
 
 Status:
-  0.0.1 reserves the public CLI name and establishes the command surface.
+  0.0.2 reserves the public CLI name and establishes the command surface.
   The add subcommands are placeholders in this initial release.`);
 }
 
@@ -24,13 +38,19 @@ if (!command || command === "help" || command === "--help" || command === "-h")
 }
 
 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");
+  if (!targets.length) {
+    console.error("Specify one or more layers: teleology, identity, project, skills");
+    process.exit(1);
+  }
+
+  const invalid = targets.filter((target) => !supportedSet.has(target));
+  if (invalid.length) {
+    console.error(`Unknown layer(s): ${invalid.join(", ")}`);
+    console.error(`Supported layers: ${supported.join(", ")}`);
     process.exit(1);
   }
 
-  console.log(`architectonic add ${target}`);
+  console.log(`architectonic add ${targets.join(" ")}`);
   console.log("");
   console.log("This placeholder release does not install packages yet.");
   console.log("It reserves the command contract for future cascade/install behavior.");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "architectonic",
-  "version": "0.0.1",
-  "description": "CLI for installing and wiring agentic system layers such as teleology, identity, project, and skills.",
+  "version": "0.0.2",
+  "description": "CLI for composing agentic system layers such as teleology, identity, project, and skills.",
   "license": "Apache-2.0",
   "type": "module",
   "bin": {