@prestack/thread 0.0.2 → 0.1.0

package/dist/operations/makers/capability.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/operations/makers/capability.js

@@ -1,117 +0,0 @@
-import { spawnSync } from 'node:child_process';
-import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { resolve } from 'node:path';
-import { argv, exit, stdout } from 'node:process';
-import { RECEIPT, answer, asking, given, issue, only, refuse, spend, wordsIn } from "../../core/asking.js";
-import { findTree } from "../../core/tree.js";
-import { CAPABILITIES_AT, SURFACES, isSurface } from "../capabilities.js";
-const TREE = findTree();
-const at = resolve(TREE.at, CAPABILITIES_AT);
-if (!existsSync(at)) {
-    refuse(`${CAPABILITIES_AT} is not there, so this app has nothing reachable to switch. Declare an operation with ` +
-        '`thread create operation` — it writes this table on its way out — or run `thread capabilities`.');
-}
-let table;
-try {
-    table = JSON.parse(readFileSync(at, 'utf8'));
-}
-catch (thrown) {
-    refuse(`${CAPABILITIES_AT} could not be read: ${thrown instanceof Error ? thrown.message : String(thrown)}. ` +
-        'Run `thread capabilities` — it is derived, so it can always be written again.');
-}
-if (table.length === 0) {
-    refuse('this app declares no operation, so there is nothing to switch on or off yet.');
-}
-const mark = (one) => [
-    `  ${one.operation} — ${one.describes}`,
-    `      ${SURFACES.map((each) => `${one.live.includes(each) ? '[on] ' : '[off]'} ${each}`).join('   ')}`,
-    `      ${one.browsable ? 'may be called from a page' : 'server only — it reaches a target that needs a server secret'}`,
-];
-const listing = [`${String(table.length)} operation(s):`, ...table.flatMap(mark)].join('\n');
-const words = wordsIn(['edit']);
-const verb = words[0];
-stdout.write(`${listing}\n`);
-const ASKS = [
-    {
-        key: 'live',
-        says: [
-            'which surfaces are on, comma-separated. Answering nothing switches every',
-            'one of them off, which leaves the operation declared, compiled and proven',
-            'and reachable by nobody — a real thing to want, and said out loud rather',
-            'than refused.',
-        ],
-    },
-];
-const TAKES = ASKS.map((one) => one.key);
-const ASKED = ASKS.flatMap((one) => one.says.map((line, at) => `  ${at === 0 ? `${one.key}:`.padEnd(8) : ' '.repeat(8)}${line}`));
-const method = (nonce) => [
-    '',
-    'what this changes:',
-    '',
-    `  thread create capability edit <operation> ${RECEIPT} ${nonce}`,
-    '',
-    `  ${RECEIPT} is spent by one run and refused if the table moved after it was issued.`,
-    '',
-    `a surface is a way this app is CALLED, and there are ${String(SURFACES.length)}: ${SURFACES.join(', ')}.`,
-    '',
-    '  cli   a command a terminal runs',
-    '  api   a route a request arrives on, and the OpenAPI document written from it',
-    '  mcp   a tool an agent is offered. Switch this off and an AI actor cannot call the operation,',
-    '        while everything else about it goes on working',
-    '',
-    '`edit` asks, one answer per line:',
-    '',
-    ...ASKED,
-    '',
-    'It writes the flag and runs `thread capabilities`, which carries every flag across and rewrites',
-    'the tool list, the OpenAPI document and the client bundle from them.',
-].join('\n');
-const flagged = argv.indexOf(RECEIPT);
-if (verb === undefined && flagged === -1) {
-    const nonce = issue(TREE.at, listing);
-    stdout.write(`${method(nonce)}\n`);
-    stdout.write(`\ncapability: receipt ${nonce} — spent on use, and stale the moment ${CAPABILITIES_AT} changes.\n`);
-    exit(0);
-}
-spend(TREE.at, listing, argv[flagged + 1], CAPABILITIES_AT);
-if (verb !== 'edit') {
-    refuse(`there is nothing called "${verb ?? ''}" to do here — say edit. A capability is derived, so there is none to add`);
-}
-const which = words[1];
-if (which === undefined) {
-    refuse('`edit` takes the name of an operation this app declares');
-}
-const one = table.find((each) => each.operation === which);
-if (one === undefined) {
-    refuse(`\`${which}\` is not an operation this app declares. What is here is ${table.map((each) => each.operation).join(', ')}`);
-}
-const piped = given();
-only(piped, TAKES, 'editing a capability');
-const { ask, shut } = asking(piped);
-const said = (piped.length > 0
-    ? (answer(piped, 'live') ?? '')
-    : await ask('live', `which surfaces are on — ${SURFACES.join(', ')} (now: ${one.live.join(', ') || 'none'}): `)).trim();
-shut();
-const wanted = said
-    .split(',')
-    .map((each) => each.trim().toLowerCase())
-    .filter((each) => each !== '');
-const wrong = wanted.filter((each) => !isSurface(each));
-if (wrong.length > 0) {
-    refuse(`there is no surface called ${wrong.map((each) => `"${each}"`).join(', ')}. There are ${String(SURFACES.length)}: ` +
-        `${SURFACES.join(', ')}. Nothing was written.`);
-}
-const live = SURFACES.filter((each) => wanted.includes(each));
-writeFileSync(at, `${JSON.stringify(table.map((each) => (each.operation === one.operation ? { ...each, live } : each)), null, 2)}\n`);
-const off = SURFACES.filter((each) => !live.includes(each));
-stdout.write(`capability: ${one.operation} is live on ${live.join(', ') || 'nothing'}` +
-    `${off.length === 0 ? '' : `, and off for ${off.join(', ')}`}.\n`);
-for (const what of [['capabilities'], ['docs']]) {
-    const made = spawnSync('npx', ['thread', ...what], { cwd: TREE.at, encoding: 'utf8' });
-    stdout.write(`${`${made.stdout ?? ''}${made.stderr ?? ''}`.trim()}\n`);
-    if (made.status !== 0) {
-        stdout.write(`capability: the flag is written and stands; \`thread ${what.join(' ')}\` refused above.\n`);
-        exit(1);
-    }
-}
-exit(0);

package/dist/operations/makers/capability.ts

@@ -1,166 +0,0 @@
-import { spawnSync } from 'node:child_process'
-import { existsSync, readFileSync, writeFileSync } from 'node:fs'
-import { resolve } from 'node:path'
-import { argv, exit, stdout } from 'node:process'
-
-import { RECEIPT, answer, asking, given, issue, only, refuse, spend, wordsIn } from '../../core/asking.ts'
-import { findTree } from '../../core/tree.ts'
-
-import { CAPABILITIES_AT, SURFACES, isSurface, type Capability, type Surface } from '../capabilities.ts'
-
-const TREE = findTree()
-
-const at = resolve(TREE.at, CAPABILITIES_AT)
-
-if (!existsSync(at)) {
-  refuse(
-    `${CAPABILITIES_AT} is not there, so this app has nothing reachable to switch. Declare an operation with ` +
-      '`thread create operation` — it writes this table on its way out — or run `thread capabilities`.',
-  )
-}
-
-let table: readonly Capability[]
-try {
-  table = JSON.parse(readFileSync(at, 'utf8')) as readonly Capability[]
-} catch (thrown) {
-  refuse(
-    `${CAPABILITIES_AT} could not be read: ${thrown instanceof Error ? thrown.message : String(thrown)}. ` +
-      'Run `thread capabilities` — it is derived, so it can always be written again.',
-  )
-}
-
-if (table.length === 0) {
-  refuse('this app declares no operation, so there is nothing to switch on or off yet.')
-}
-
-const mark = (one: Capability): readonly string[] => [
-  `  ${one.operation} — ${one.describes}`,
-  `      ${SURFACES.map((each) => `${one.live.includes(each) ? '[on] ' : '[off]'} ${each}`).join('   ')}`,
-  `      ${one.browsable ? 'may be called from a page' : 'server only — it reaches a target that needs a server secret'}`,
-]
-
-const listing = [`${String(table.length)} operation(s):`, ...table.flatMap(mark)].join('\n')
-
-const words = wordsIn(['edit'])
-
-const verb = words[0]
-
-stdout.write(`${listing}\n`)
-
-const ASKS: readonly { readonly key: string; readonly says: readonly string[] }[] = [
-  {
-    key: 'live',
-    says: [
-      'which surfaces are on, comma-separated. Answering nothing switches every',
-      'one of them off, which leaves the operation declared, compiled and proven',
-      'and reachable by nobody — a real thing to want, and said out loud rather',
-      'than refused.',
-    ],
-  },
-]
-
-const TAKES: readonly string[] = ASKS.map((one) => one.key)
-
-const ASKED: readonly string[] = ASKS.flatMap((one) =>
-  one.says.map((line, at) => `  ${at === 0 ? `${one.key}:`.padEnd(8) : ' '.repeat(8)}${line}`),
-)
-
-const method = (nonce: string): string =>
-  [
-    '',
-    'what this changes:',
-    '',
-    `  thread create capability edit <operation> ${RECEIPT} ${nonce}`,
-    '',
-    `  ${RECEIPT} is spent by one run and refused if the table moved after it was issued.`,
-    '',
-    `a surface is a way this app is CALLED, and there are ${String(SURFACES.length)}: ${SURFACES.join(', ')}.`,
-    '',
-    '  cli   a command a terminal runs',
-    '  api   a route a request arrives on, and the OpenAPI document written from it',
-    '  mcp   a tool an agent is offered. Switch this off and an AI actor cannot call the operation,',
-    '        while everything else about it goes on working',
-    '',
-    '`edit` asks, one answer per line:',
-    '',
-    ...ASKED,
-    '',
-    'It writes the flag and runs `thread capabilities`, which carries every flag across and rewrites',
-    'the tool list, the OpenAPI document and the client bundle from them.',
-  ].join('\n')
-
-const flagged = argv.indexOf(RECEIPT)
-
-if (verb === undefined && flagged === -1) {
-  const nonce = issue(TREE.at, listing)
-  stdout.write(`${method(nonce)}\n`)
-  stdout.write(`\ncapability: receipt ${nonce} — spent on use, and stale the moment ${CAPABILITIES_AT} changes.\n`)
-  exit(0)
-}
-
-spend(TREE.at, listing, argv[flagged + 1], CAPABILITIES_AT)
-
-if (verb !== 'edit') {
-  refuse(`there is nothing called "${verb ?? ''}" to do here — say edit. A capability is derived, so there is none to add`)
-}
-
-const which = words[1]
-if (which === undefined) {
-  refuse('`edit` takes the name of an operation this app declares')
-}
-
-const one = table.find((each) => each.operation === which)
-if (one === undefined) {
-  refuse(`\`${which}\` is not an operation this app declares. What is here is ${table.map((each) => each.operation).join(', ')}`)
-}
-
-const piped = given()
-only(piped, TAKES, 'editing a capability')
-const { ask, shut } = asking(piped)
-
-const said = (
-  piped.length > 0
-    ? (answer(piped, 'live') ?? '')
-    : await ask('live', `which surfaces are on — ${SURFACES.join(', ')} (now: ${one.live.join(', ') || 'none'}): `)
-).trim()
-shut()
-
-const wanted = said
-  .split(',')
-  .map((each) => each.trim().toLowerCase())
-  .filter((each) => each !== '')
-
-const wrong = wanted.filter((each) => !isSurface(each))
-if (wrong.length > 0) {
-  refuse(
-    `there is no surface called ${wrong.map((each) => `"${each}"`).join(', ')}. There are ${String(SURFACES.length)}: ` +
-      `${SURFACES.join(', ')}. Nothing was written.`,
-  )
-}
-
-const live = SURFACES.filter((each) => wanted.includes(each))
-
-writeFileSync(
-  at,
-  `${JSON.stringify(
-    table.map((each) => (each.operation === one.operation ? { ...each, live } : each)),
-    null,
-    2,
-  )}\n`,
-)
-
-const off = SURFACES.filter((each) => !live.includes(each))
-stdout.write(
-  `capability: ${one.operation} is live on ${live.join(', ') || 'nothing'}` +
-    `${off.length === 0 ? '' : `, and off for ${off.join(', ')}`}.\n`,
-)
-
-for (const what of [['capabilities'], ['docs']]) {
-  const made = spawnSync('npx', ['thread', ...what], { cwd: TREE.at, encoding: 'utf8' })
-  stdout.write(`${`${made.stdout ?? ''}${made.stderr ?? ''}`.trim()}\n`)
-  if (made.status !== 0) {
-    stdout.write(`capability: the flag is written and stands; \`thread ${what.join(' ')}\` refused above.\n`)
-    exit(1)
-  }
-}
-exit(0)

package/dist/operations/makers/trial.d.ts

@@ -1 +0,0 @@
-export {};