strckro 0.2.0 → 0.3.0

package/DOCUMENTATION.md

@@ -1,6 +1,6 @@
 # Strckro CLI — เอกสารการใช้งาน
 
-เวอร์ชัน CLI: `0.2.0`  
+เวอร์ชัน CLI: `0.3.0`  
 คำสั่ง: `skctl`  
 อัปเดตเอกสาร: 6 พฤศจิกายน 2026
 
@@ -47,10 +47,10 @@ npx --package strckro skctl --help
 npm run pack:release
 ```
 
-ส่ง `strckro-0.2.0.tgz` ไปยังเครื่องอื่นแล้วรัน:
+ส่ง `strckro-0.3.0.tgz` ไปยังเครื่องอื่นแล้วรัน:
 
 ```sh
-npm install --global ./strckro-0.2.0.tgz
+npm install --global ./strckro-0.3.0.tgz
 skctl --version
 ```
 
@@ -188,15 +188,28 @@ skctl init --project my-app
 
 Credential ที่บันทึกไว้จะใช้กับ server origin เดิมเท่านั้น สามารถใช้ `STRCKRO_TOKEN` สำหรับ CI โดยไม่บันทึก credential ลงเครื่อง
 
+**token ไปได้เฉพาะ server ที่คุณเลือกเอง:** `strckro.json` เป็นไฟล์ใน repository ซึ่งอาจมาจากคนอื่น (repo ที่ clone มา, fork ใน CI, repo ที่ AI agent เปิด) CLI จึงไม่ส่ง token ที่คุณให้ (`STRCKRO_TOKEN`, `login --token`, `login --token-stdin`) ไปยัง server ที่ระบุอยู่ใน `strckro.json` เพียงอย่างเดียว Token จะถูกส่งเมื่อ server มาจาก `--server`, `STRCKRO_SERVER` หรือเป็น origin เดียวกับที่ login ไว้บนเครื่องนี้ มิฉะนั้นคำสั่งจะหยุดด้วย exit 2 โดยยังไม่ส่งคำขอใดออกไป CI ที่ใช้ `STRCKRO_TOKEN` ให้ตั้ง `STRCKRO_SERVER` คู่กันเสมอ เช่นเดียวกับตัวอย่างในหัวข้อ CI
+
 ## 6. สร้างและซิงก์โปรเจค
 
 ### ดูรายการและสถานะ
 
 ```sh
+skctl projects list
+skctl project my-app --info
+skctl project --info
 skctl projects list --json
-skctl projects status my-app --json
+skctl project my-app --info --json
 ```
 
+`projects list` แสดงเฉพาะ slug, ประเภทงาน (`web`/`worker`), runtime, deployment และ process หนึ่งบรรทัดต่อโปรเจค ไม่แสดง repository, release history หรือ logs ในรายการ
+
+`project [SLUG] --info` แสดงข้อมูลทีละโปรเจค: ชื่อ, source, branch/directory, sync, active/previous release, งาน deploy และ domains หากไม่ระบุ slug จะใช้ลำดับเลือกโปรเจคในหัวข้อ 5 ส่วน `project [SLUG]` แสดงตารางสรุปเฉพาะโปรเจคนั้น
+
+Deployment `active` แสดงสถานะ release ที่บันทึกไว้ ส่วน process เป็นผล runtime probe แยกกัน `unknown` หมายถึงยังยืนยันสถานะ process ไม่ได้ จึงไม่ควรใช้ deployment state เพียงอย่างเดียวสรุปว่าแอป healthy
+
+เติม `--json` เพื่อรับข้อมูล API ครบเหมือนเดิม รวม release history และ metadata ที่ token มีสิทธิ์อ่าน โดย stdout เป็น JSON object เดียว ไม่มีตารางหรือข้อความแนะนำ `skctl projects status [SLUG] --json` ยังคงใช้ได้ตามเดิม และให้โครงสร้างเดียวกับ `skctl project [SLUG] --info --json`
+
 ### สร้างหรืออัปเดตจากไฟล์
 
 สร้าง `project.json` เช่น:
@@ -410,7 +423,7 @@ Token ไม่สามารถจัดการบัญชี/สิทธ
 | Environment variable | ความหมาย |
 | --- | --- |
 | `STRCKRO_SERVER` | Origin ของ Portal |
-| `STRCKRO_TOKEN` | Token สำหรับ process/CI โดยไม่ต้อง login บันทึกลงเครื่อง |
+| `STRCKRO_TOKEN` | Token สำหรับ process/CI โดยไม่ต้อง login บันทึกลงเครื่อง ใช้คู่กับ `STRCKRO_SERVER` หรือ `--server` (ไม่ส่งไปยัง server ที่มาจาก `strckro.json` อย่างเดียว) |
 | `STRCKRO_PROJECT` | Default project slug |
 | `STRCKRO_CONFIG_DIR` | เปลี่ยนโฟลเดอร์เก็บ credential |
 | `XDG_CONFIG_HOME` | Base config directory หากไม่ได้กำหนด `STRCKRO_CONFIG_DIR` |

package/PUBLISHING.md

@@ -5,6 +5,8 @@
 Registry: `https://registry.npmjs.org/`  
 การเข้าถึง: public
 
+รุ่น 0.3.0 เปลี่ยน `projects list` เป็นตารางสรุปหนึ่งบรรทัดต่อโปรเจค เพิ่ม `project [SLUG] --info` สำหรับเจาะรายละเอียด และคงข้อมูล `--json` กับคำสั่ง `projects status` เดิมไว้
+
 ## ตรวจแพ็กเกจก่อนเผยแพร่
 
 ```sh
@@ -53,10 +55,10 @@ skctl --version
 npm run pack:release
 ```
 
-จะได้ `strckro-0.2.0.tgz` ตามเวอร์ชันปัจจุบัน ส่งไฟล์นี้ไปยังเครื่องอื่นแล้วติดตั้งได้ทันที:
+จะได้ `strckro-0.3.0.tgz` ตามเวอร์ชันปัจจุบัน ส่งไฟล์นี้ไปยังเครื่องอื่นแล้วติดตั้งได้ทันที:
 
 ```sh
-npm install --global ./strckro-0.2.0.tgz
+npm install --global ./strckro-0.3.0.tgz
 skctl --version
 skctl login --server https://portal.example.com --no-browser
 ```

package/README.md

@@ -23,7 +23,7 @@ npx --package strckro skctl --help
 ```sh
 npm run pack:release
 # On the other machine:
-npm install --global ./strckro-0.2.0.tgz
+npm install --global ./strckro-0.3.0.tgz
 ```
 
 ดู [เอกสารฉบับเต็ม](DOCUMENTATION.md) และ [ขั้นตอน publish](PUBLISHING.md)
@@ -63,7 +63,8 @@ Windows เก็บ credential ด้วย DPAPI ผูกกับ OS user; L
 ## โปรเจคและ deploy
 
 ```sh
-skctl projects list --json
+skctl projects list
+skctl project my-app --info
 skctl init --project my-app
 skctl projects status --json
 skctl deployments list --json
@@ -76,8 +77,12 @@ skctl rollback --release RELEASE_ID
 skctl jobs status JOB_ID
 ```
 
+`projects list` แสดงตารางหนึ่งบรรทัดต่อโปรเจค มี slug, ประเภทงาน, runtime และสถานะ deployment/process ดูรายละเอียดด้วย `project [SLUG] --info` หรือใช้โปรเจคจาก `--project`, environment และ `strckro.json` เมื่อไม่ระบุ slug `project [SLUG]` แสดงตารางเฉพาะโปรเจคนั้น `--json` ยังคงคืนข้อมูล API ครบสำหรับ AI/CI ทั้ง list และรายละเอียด และ `projects status [SLUG]` ยังใช้ได้ตามเดิม
+
 `init` สร้าง `strckro.json` เก็บแค่ server/project ไม่มี token ไม่เขียนทับไฟล์เดิม อาจ commit ให้ทีมใช้ร่วมกันได้ ลำดับเลือก server: `--server`, `STRCKRO_SERVER`, `strckro.json`, credential ที่บันทึก; project: `--project`, positional slug, `STRCKRO_PROJECT`, `strckro.json`
 
+`strckro.json` เป็นไฟล์ใน repository ที่อาจมาจากคนอื่น จึงไม่ถูกใช้เป็นปลายทางของ token ที่คุณให้เอง (`STRCKRO_TOKEN`, `login --token`, `--token-stdin`): token จะส่งเฉพาะเมื่อ server มาจาก `--server`, `STRCKRO_SERVER` หรือ origin ที่ login ไว้บนเครื่องนี้ มิฉะนั้นคำสั่งหยุดด้วย exit 2 โดยไม่ส่งคำขอ ใน CI ให้ตั้ง `STRCKRO_SERVER` คู่กับ `STRCKRO_TOKEN`
+
 สร้างโปรเจคด้วย `project.json` ตาม `POST /api/projects/sync` เช่น:
 
 ```json

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "strckro",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Strckro deployment control plane CLI for people, CI, and AI agents",
   "keywords": [
     "strckro",

package/src/cli.mjs

@@ -1,4 +1,4 @@
-import { parseArgs } from 'node:util';
+import { parseArgs, stripVTControlCharacters } from 'node:util';
 import { readFileSync } from 'node:fs';
 import { readFile, writeFile } from 'node:fs/promises';
 import { hostname } from 'node:os';
@@ -21,7 +21,8 @@ Authentication:
 
 Projects and deployment:
   init --project SLUG                   Save server/project to ./strckro.json
-  projects list
+  projects list                        Compact project overview
+  project [SLUG] [--info]               Overview or details for one project
   projects status [SLUG]
   projects sync --file project.json      Create/update and sync a Git project
   deployments list [SLUG]                List deployment history and active jobs
@@ -52,6 +53,8 @@ Global options:
 
 Environment: STRCKRO_SERVER, STRCKRO_TOKEN, STRCKRO_PROJECT,
              STRCKRO_CONFIG_DIR, XDG_CONFIG_HOME
+A token (STRCKRO_TOKEN or login --token) is sent only to --server, STRCKRO_SERVER
+or the server of your saved login, never to one named only by ./strckro.json.
 Legacy DASHBOARD_* variables and dpctl.json remain supported.
 Exit codes: 0 success; 1 API/deployment; 2 input; 3 authentication;
             4 permission denied; 5 stale environment; 6 network/timeout.
@@ -60,12 +63,43 @@ Use --json for AI/CI: stdout contains one JSON object; progress goes to stderr.
 `;
 
 const stringOptions = ['server', 'token', 'project', 'scope', 'name', 'days', 'file', 'domains', 'hostname', 'release', 'revision', 'timeout'];
-const booleanOptions = ['json', 'help', 'version', 'no-browser', 'token-stdin', 'stdin', 'empty', 'wait', 'sync'];
+const booleanOptions = ['json', 'help', 'version', 'no-browser', 'token-stdin', 'stdin', 'empty', 'wait', 'sync', 'info'];
 const options = Object.fromEntries([...stringOptions.map(key => [key, { type: 'string' }]), ...booleanOptions.map(key => [key, { type: 'boolean' }])]);
 const slug = value => { if (!/^[a-z][a-z0-9-]{0,62}$/.test(value || '')) throw new CliError('Specify a valid project slug with --project or skctl init.'); return value; };
 const keyName = value => { if (!/^[A-Z_][A-Z0-9_]*$/.test(value || '')) throw new CliError('Specify an uppercase environment key.'); return value; };
 const required = (value, flag) => { if (!value) throw new CliError(`Provide ${flag}.`); return value; };
 
+// Keep each table entry on one line, even when a server field contains control characters.
+const display = value => stripVTControlCharacters(String(value ?? '')).replace(/[\u0000-\u001f\u007f-\u009f]/g, ' ').replace(/\s+/g, ' ').trim() || '-';
+
+function projectList(projects) {
+  if (!projects.length) return 'No projects found.\n';
+  const rows = [
+    ['SLUG', 'TYPE', 'RUNTIME', 'DEPLOYMENT', 'PROCESS'],
+    ...projects.map(item => [item.slug, item.serviceType || 'web', item.runtime, item.deployment?.state, item.runtimeStatus?.state || 'unknown'].map(display))
+  ];
+  const widths = rows[0].map((_, index) => Math.max(...rows.map(row => row[index].length)));
+  return rows.map(row => row.map((value, index) => value.padEnd(widths[index])).join('  ').trimEnd()).join('\n')
+    + `\n\n${projects.length} project${projects.length === 1 ? '' : 's'}. Details: skctl project <slug> --info\n`;
+}
+
+function projectInfo(item) {
+  const rows = [
+    ['Name', item.name], ['Slug', item.slug], ['Type', item.serviceType || 'web'], ['Runtime', item.runtime],
+    ['Deployment', item.deployment?.state], ['Process', item.runtimeStatus?.state || 'unknown'],
+    ['Process checked', item.runtimeStatus?.checkedAt],
+    ['Active release', item.deployment?.activeReleaseId], ['Previous release', item.deployment?.previousReleaseId],
+    ['Deployment updated', item.deployment?.updatedAt],
+    ['Deploy job', item.deploymentProgress?.id], ['Job status', item.deploymentProgress?.status], ['Job phase', item.deploymentProgress?.phase],
+    ['Repository', item.repository], ['Branch', item.branch], ['Directory', item.directory],
+    ['Source sync', item.sync?.status], ['Source synced', item.sync?.at],
+    ['Domains', item.domains?.hosts?.join(', ') || '(none)']
+  ];
+  const width = Math.max(...rows.map(([label]) => label.length));
+  return rows.map(([label, value]) => `${label.padEnd(width)}  ${display(value)}`).join('\n')
+    + '\n\nUse --json for the complete project data.\n';
+}
+
 async function stdinText(input) {
   if (input.isTTY) throw new CliError('Pipe the value into stdin.');
   const chunks = []; let size = 0;
@@ -116,9 +150,10 @@ export async function run(argv, { env = process.env, cwd = process.cwd(), stdout
     const [command, action, ...rest] = args;
     // Logout does not need a working server or credential decryption.
     if (command === 'logout') { if (args.length !== 1) throw new CliError('Usage: skctl logout'); await clearConfig(env); print({ ok: true, message: 'Saved credential removed. Revoke it in Portal Settings > Account to invalidate it.' }); return 0; }
-    const supported = ['login', 'whoami', 'init', 'projects', 'deployments', 'deploy', 'restart', 'rollback', 'jobs', 'logs', 'domains', 'env'];
+    const supported = ['login', 'whoami', 'init', 'project', 'projects', 'deployments', 'deploy', 'restart', 'rollback', 'jobs', 'logs', 'domains', 'env'];
     if (!supported.includes(command)) throw new CliError('Unknown command. Run skctl --help.');
     const commandOptions = command === 'login' ? ['token', 'token-stdin', 'no-browser', 'scope', 'name', 'days']
+      : command === 'project' ? ['info']
       : command === 'projects' && action === 'sync' ? ['file']
       : command === 'deploy' ? ['sync', 'wait']
       : command === 'rollback' ? ['release']
@@ -126,10 +161,18 @@ export async function run(argv, { env = process.env, cwd = process.cwd(), stdout
       : command === 'env' ? action === 'set' ? ['stdin', 'file', 'empty', 'revision'] : action === 'unset' ? ['revision'] : action === 'import' ? ['file', 'revision'] : action === 'pull' ? ['file'] : [] : [];
     for (const flag of Object.keys(flags)) if (!['server', 'project', 'json', 'timeout', 'help', 'version', ...commandOptions].includes(flag)) throw new CliError(`--${flag} does not apply to this command.`);
     const local = await localProject(cwd);
-    const requestedServer = flags.server || env.DASHBOARD_SERVER || local.server;
+    const explicitServer = flags.server || env.DASHBOARD_SERVER;
+    const requestedServer = explicitServer || local.server;
     const needsCredential = command !== 'login' && !env.DASHBOARD_TOKEN;
-    let saved = !requestedServer || needsCredential ? await readConfig(env, { secret: false }) : {};
+    // A token the person supplies (STRCKRO_TOKEN, or login --token/--token-stdin) is a bearer
+    // secret, and a login, even by browser approval, ends by replacing the credential saved on this
+    // machine. strckro.json is repository content, possibly from a stranger, so it must not pick
+    // the server for either: only --server, STRCKRO_SERVER or the origin already logged in to on
+    // this machine may be trusted with them.
+    const needsTrustedServer = command === 'login' || Boolean(env.DASHBOARD_TOKEN);
+    let saved = !requestedServer || needsCredential || (needsTrustedServer && !explicitServer) ? await readConfig(env, { secret: false }) : {};
     const server = normalizeServer(requestedServer || saved.server);
+    if (needsTrustedServer && !explicitServer && saved.server !== server) throw new CliError(`Refusing to use ${server}: that server comes only from strckro.json, which is repository content, so no token or login is sent there. Pass --server or set STRCKRO_SERVER to the Portal you trust.`);
     if (needsCredential && saved.server === server) saved = await readConfig(env);
     const timeout = flags.timeout === undefined ? 30 : Number(flags.timeout);
     if (!Number.isFinite(timeout) || timeout < 1 || timeout > 3600) throw new CliError('Timeout must be 1–3600 seconds.');
@@ -185,6 +228,12 @@ export async function run(argv, { env = process.env, cwd = process.cwd(), stdout
       if (!projects.some(item => item.slug === target)) throw new CliError('Project not found.', 'API_ERROR', 404);
       await writeFile(resolve(cwd, 'strckro.json'), JSON.stringify({ server, project: target }, null, 2) + '\n', { flag: 'wx' });
       result = { ok: true, server, project: target, file: resolve(cwd, 'strckro.json') };
+    } else if (command === 'project') {
+      if (args.length > 2) throw new CliError('Usage: skctl project [SLUG] [--info]');
+      const target = project(action);
+      const { projects } = await api('/api/projects');
+      result = { project: projects.find(item => item.slug === target) };
+      if (!result.project) throw new CliError('Project not found.', 'API_ERROR', 404);
     } else if (command === 'projects') {
       if (!['list', 'status', 'sync'].includes(action) || rest.length > (action === 'status' ? 1 : 0)) throw new CliError('Usage: skctl projects list|status [SLUG]|sync --file project.json');
       if (action === 'sync') {
@@ -259,7 +308,9 @@ export async function run(argv, { env = process.env, cwd = process.cwd(), stdout
         result = await api(endpoint, { method: 'PATCH', body: { revision, set, unset } });
       }
     }
-    print({ ok: true, ...result });
+    if (!json && result?.ok !== false && command === 'projects' && action === 'list') stdout.write(projectList(result.projects));
+    else if (!json && result?.ok !== false && command === 'project') stdout.write(flags.info ? projectInfo(result.project) : projectList([result.project]));
+    else print({ ok: true, ...result });
     return result?.ok === false ? 1 : 0;
   } catch (error) {
     const message = error instanceof CliError ? error.message : error.code === 'EEXIST' ? 'Output file already exists; choose a new path.' : error.code?.startsWith('E') ? 'Could not access the requested file or configuration.' : error.message || 'Command failed.';