@launch11/srgical 0.0.4 → 0.0.5

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+Release history is tracked through git tags, GitHub Releases, GitHub Packages, and npm.
+
+The repo keeps a base version line in `package.json`, and CI computes the next patch version at release time.
+
+## Notes
+
+- Detailed per-release notes currently live on GitHub Releases.
+- Run `srgical changelog` to jump straight to the installed version's release notes.
+- Run `srgical about` for package, release, and support details.

package/README.md

@@ -27,9 +27,15 @@ plan. It creates momentum:
 
 This repo currently ships the foundation for:
 
+- `srgical --version`
+  Prints the installed version with release-note links instead of only echoing the semver.
 - `srgical doctor`
   Reports whether the current workspace has a planning pack, which supported agent is active, and which supported
   agents are available locally.
+- `srgical about`
+  Shows package details, release links, and the currently supported agent adapters.
+- `srgical changelog`
+  Points straight at the installed version's release notes and the local packaged changelog.
 - `srgical init`
   Creates a local `.srgical/` planning pack from built-in templates.
 - `srgical studio`
@@ -138,7 +144,10 @@ npm run dev -- studio
 Typical flow once a workspace has a pack:
 
 ```bash
+node dist/index.js --version
+node dist/index.js about
 node dist/index.js doctor
+node dist/index.js changelog
 node dist/index.js run-next --dry-run
 node dist/index.js run-next
 ```

package/dist/commands/about.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runAboutCommand = runAboutCommand;
+exports.renderAboutSummary = renderAboutSummary;
+const node_process_1 = __importDefault(require("node:process"));
+const agent_1 = require("../core/agent");
+const package_info_1 = require("../core/package-info");
+function runAboutCommand() {
+    node_process_1.default.stdout.write(`${renderAboutSummary()}\n`);
+}
+function renderAboutSummary() {
+    const info = (0, package_info_1.readInstalledPackageInfo)();
+    const supportedAgents = (0, agent_1.getSupportedAgentAdapters)().map((adapter) => adapter.id).join(", ");
+    return [
+        "srgical",
+        `Version: ${info.version}`,
+        `Package: ${info.name}`,
+        `Description: ${info.description}`,
+        info.homepage ? `Homepage: ${info.homepage}` : null,
+        info.repositoryUrl ? `Repository: ${info.repositoryUrl}` : null,
+        info.issuesUrl ? `Issues: ${info.issuesUrl}` : null,
+        info.releaseNotesUrl ? `Release notes: ${info.releaseNotesUrl}` : null,
+        info.releasesUrl ? `All releases: ${info.releasesUrl}` : null,
+        `Supported agents: ${supportedAgents || "none registered"}`,
+        "Next steps: `srgical doctor`, `srgical studio`, or `srgical changelog`"
+    ]
+        .filter(Boolean)
+        .join("\n");
+}

package/dist/commands/changelog.js

@@ -0,0 +1,29 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runChangelogCommand = runChangelogCommand;
+exports.renderChangelogSummary = renderChangelogSummary;
+const node_process_1 = __importDefault(require("node:process"));
+const package_info_1 = require("../core/package-info");
+function runChangelogCommand() {
+    node_process_1.default.stdout.write(`${renderChangelogSummary()}\n`);
+}
+function renderChangelogSummary() {
+    const info = (0, package_info_1.readInstalledPackageInfo)();
+    const changelog = (0, package_info_1.readLocalChangelog)();
+    const placeholder = (0, package_info_1.isPlaceholderChangelog)(changelog);
+    return [
+        `Installed version: ${info.version}`,
+        info.releaseNotesUrl ? `Release notes: ${info.releaseNotesUrl}` : null,
+        info.releasesUrl ? `All releases: ${info.releasesUrl}` : null,
+        "",
+        placeholder
+            ? "Local package changelog is currently minimal. Use the release notes URL above for the detailed upgrade notes."
+            : "Local CHANGELOG.md:",
+        !placeholder && changelog ? changelog : null
+    ]
+        .filter((line) => line !== null)
+        .join("\n");
+}

package/dist/commands/version.js

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runVersionCommand = runVersionCommand;
+exports.renderVersionSummary = renderVersionSummary;
+const node_process_1 = __importDefault(require("node:process"));
+const package_info_1 = require("../core/package-info");
+function runVersionCommand() {
+    node_process_1.default.stdout.write(`${renderVersionSummary()}\n`);
+}
+function renderVersionSummary() {
+    const info = (0, package_info_1.readInstalledPackageInfo)();
+    return [
+        `srgical ${info.version}`,
+        info.description,
+        `Package: ${info.name}`,
+        info.releaseNotesUrl ? `Release notes: ${info.releaseNotesUrl}` : null,
+        info.releasesUrl ? `All releases: ${info.releasesUrl}` : null,
+        "More: run `srgical about`"
+    ]
+        .filter(Boolean)
+        .join("\n");
+}

package/dist/core/package-info.js

@@ -0,0 +1,61 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readInstalledPackageInfo = readInstalledPackageInfo;
+exports.readLocalChangelog = readLocalChangelog;
+exports.isPlaceholderChangelog = isPlaceholderChangelog;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+function readInstalledPackageInfo() {
+    const packageRoot = resolvePackageRoot();
+    const packageJsonPath = node_path_1.default.join(packageRoot, "package.json");
+    const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, "utf8"));
+    const repositoryUrl = normalizeRepositoryUrl(packageJson.repository);
+    const releasesUrl = repositoryUrl ? `${repositoryUrl}/releases` : undefined;
+    const version = packageJson.version ?? "0.0.0";
+    return {
+        packageRoot,
+        name: packageJson.name ?? "srgical",
+        version,
+        description: packageJson.description ?? "Local-first AI planning and execution orchestration.",
+        homepage: packageJson.homepage,
+        repositoryUrl,
+        issuesUrl: packageJson.bugs?.url,
+        releasesUrl,
+        releaseNotesUrl: releasesUrl ? `${releasesUrl}/tag/v${version}` : undefined,
+        changelogPath: node_path_1.default.join(packageRoot, "CHANGELOG.md")
+    };
+}
+function readLocalChangelog() {
+    const info = readInstalledPackageInfo();
+    try {
+        return (0, node_fs_1.readFileSync)(info.changelogPath, "utf8").trim();
+    }
+    catch {
+        return null;
+    }
+}
+function isPlaceholderChangelog(content) {
+    if (!content) {
+        return true;
+    }
+    const normalized = content.replace(/\r\n/g, "\n").trim();
+    return (normalized ===
+        "# Changelog\n\nRelease history is tracked through git tags, GitHub Releases, GitHub Packages, and npm.\n\nThe repo keeps a base version line in `package.json`, and CI computes the next patch version at release time.");
+}
+function resolvePackageRoot() {
+    return node_path_1.default.resolve(__dirname, "..", "..");
+}
+function normalizeRepositoryUrl(repository) {
+    const raw = typeof repository === "string"
+        ? repository
+        : repository && typeof repository === "object"
+            ? repository.url
+            : undefined;
+    if (!raw) {
+        return undefined;
+    }
+    return raw.replace(/^git\+/, "").replace(/\.git$/, "");
+}

package/dist/index.js

@@ -1,22 +1,43 @@
 #!/usr/bin/env node
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-const node_fs_1 = require("node:fs");
-const node_path_1 = __importDefault(require("node:path"));
 const commander_1 = require("commander");
+const about_1 = require("./commands/about");
+const changelog_1 = require("./commands/changelog");
 const doctor_1 = require("./commands/doctor");
 const init_1 = require("./commands/init");
 const run_next_1 = require("./commands/run-next");
 const studio_1 = require("./commands/studio");
+const version_1 = require("./commands/version");
+const package_info_1 = require("./core/package-info");
 const program = new commander_1.Command();
-const packageVersion = readPackageVersion();
+const packageInfo = (0, package_info_1.readInstalledPackageInfo)();
+if (isStandaloneVersionRequest(process.argv.slice(2))) {
+    (0, version_1.runVersionCommand)();
+    process.exit(0);
+}
 program
     .name("srgical")
     .description("Local-first AI planning and execution orchestration.")
-    .version(packageVersion);
+    .version(packageInfo.version, "-V, --version", "Show installed version and release info.");
+program
+    .command("version")
+    .description("Show installed version and release info.")
+    .action(() => {
+    (0, version_1.runVersionCommand)();
+});
+program
+    .command("about")
+    .description("Show package, release, and supported-agent information.")
+    .action(() => {
+    (0, about_1.runAboutCommand)();
+});
+program
+    .command("changelog")
+    .description("Show where to find upgrade notes for the installed version.")
+    .action(() => {
+    (0, changelog_1.runChangelogCommand)();
+});
 program
     .command("doctor")
     .description("Inspect the workspace and local agent availability.")
@@ -53,8 +74,6 @@ program.parseAsync(process.argv).catch((error) => {
     process.stderr.write(`${message}\n`);
     process.exitCode = 1;
 });
-function readPackageVersion() {
-    const packageJsonPath = node_path_1.default.resolve(__dirname, "..", "package.json");
-    const packageJson = JSON.parse((0, node_fs_1.readFileSync)(packageJsonPath, "utf8"));
-    return packageJson.version ?? "0.0.0";
+function isStandaloneVersionRequest(args) {
+    return args.length === 1 && (args[0] === "--version" || args[0] === "-V");
 }

package/dist/postinstall.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPostinstall = runPostinstall;
+exports.renderPostinstallMessage = renderPostinstallMessage;
+exports.shouldRenderPostinstallMessage = shouldRenderPostinstallMessage;
+const node_process_1 = __importDefault(require("node:process"));
+const package_info_1 = require("./core/package-info");
+if (require.main === module) {
+    runPostinstall();
+}
+function runPostinstall() {
+    if (shouldRenderPostinstallMessage(node_process_1.default.env, node_process_1.default.stdout.isTTY === true)) {
+        node_process_1.default.stdout.write(`${renderPostinstallMessage()}\n`);
+    }
+}
+function renderPostinstallMessage() {
+    const info = (0, package_info_1.readInstalledPackageInfo)();
+    return [
+        "",
+        `srgical ${info.version} is ready.`,
+        info.releaseNotesUrl ? `Release notes: ${info.releaseNotesUrl}` : null,
+        "Start here: srgical doctor",
+        "More: srgical about",
+        ""
+    ]
+        .filter(Boolean)
+        .join("\n");
+}
+function shouldRenderPostinstallMessage(env, isTTY) {
+    const globalInstall = env.npm_config_global === "true" || env.npm_config_location === "global";
+    const logLevel = (env.npm_config_loglevel ?? "").toLowerCase();
+    const quietLogLevel = logLevel === "silent" || logLevel === "error";
+    return globalInstall && isTTY && env.CI !== "true" && !quietLogLevel;
+}

package/package.json

@@ -1,10 +1,12 @@
 {
   "name": "@launch11/srgical",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "A polished local-first CLI for planning and executing long AI-driven delivery sequences.",
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
+    "postinstall.js",
     "docs",
     "LICENSE"
   ],
@@ -15,6 +17,7 @@
     "build": "tsc -p tsconfig.json",
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
+    "postinstall": "node postinstall.js",
     "doctor": "tsx src/index.ts doctor",
     "test": "tsx --test test/**/*.test.ts",
     "test:coverage": "tsx --test --experimental-test-coverage test/**/*.test.ts"

package/postinstall.js

@@ -0,0 +1,14 @@
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const compiledEntry = path.join(__dirname, "dist", "postinstall.js");
+
+if (fs.existsSync(compiledEntry)) {
+  const postinstall = require(compiledEntry);
+
+  if (postinstall && typeof postinstall.runPostinstall === "function") {
+    postinstall.runPostinstall();
+  }
+}