@agentteams/cli 0.1.91 → 0.1.93

package/dist/commands/init.d.ts

@@ -1,13 +1,63 @@
-import type { AuthMode } from '../types/index.js';
-import { type ConventionEntryPointState, type ConventionIssue, type EnsurePostCheckoutHookResult } from '../utils/conventionLink.js';
+import { type ConventionStatusResult } from './convention.js';
+import { type DoctorResult } from './doctor.js';
+import type { AuthMode, Config } from '../types/index.js';
+import { type WorktreeInitResult } from './initWorktree.js';
+import { type EnsurePostCheckoutHookResult } from '../utils/conventionLink.js';
+export { bootstrapLinkedWorktree } from './initWorktree.js';
+export type { WorktreeEntryPointEntry, WorktreeEntryPointState, WorktreeInitResult } from './initWorktree.js';
 type InitOptions = {
     cwd?: string;
     /** Personal login is the default; `api-key` is the explicit compatibility path. */
     authMode?: AuthMode;
+    /**
+     * Raw `--agent-files` value. Absent means "decide from detection or the
+     * interactive prompt"; `none` means "create nothing" — the two are different
+     * answers, so this stays a string rather than a pre-parsed list.
+     */
+    agentFiles?: unknown;
+    /** Restore the legacy `<name>-example` write when an entry point already exists. */
+    agentFilesExample?: boolean;
+    /** Install the managed post-checkout hook even without a linked worktree. */
+    installWorktreeHook?: boolean;
+};
+export type InitReadinessStatus = 'READY' | 'DEGRADED' | 'SKIPPED';
+export type InitReadinessStage = 'project-binding' | 'credential' | 'convention-sync' | 'local-adapters';
+export type InitReadinessIssue = {
+    code: string;
+    message: string;
+};
+export type InitReadinessStep = {
+    stage: InitReadinessStage;
+    status: InitReadinessStatus;
+    issues: InitReadinessIssue[];
+    retryCommand?: string;
+};
+/**
+ * The local adapters init runs *after* the project binding and the credential
+ * are already on disk. They are reported one by one because they fail
+ * independently and each has its own repair command — collapsing them into a
+ * single verdict is what used to turn one unwritable file into
+ * "Initialization failed".
+ */
+export type InitAdapterName = 'gitignore' | 'agent-entry-points' | 'gemini-ignore' | 'post-checkout-hook';
+export type InitAdapterOutcome = {
+    adapter: InitAdapterName;
+    status: InitReadinessStatus;
+    issues: InitReadinessIssue[];
+    retryCommand?: string;
 };
 export type AgentFileEntry = {
     relativePath: string;
-    type: 'created' | 'example';
+    type: 'created' | 'example' | 'skipped';
+};
+/** One entry point path that could not be written, and why. */
+export type AgentEntryPointWriteFailure = {
+    relativePath: string;
+    message: string;
+};
+export type AgentEntryPointWriteResult = {
+    entries: AgentFileEntry[];
+    failures: AgentEntryPointWriteFailure[];
 };
 type OAuthInitResult = {
     success: true;
@@ -28,34 +78,67 @@ type OAuthInitResult = {
         nickname: string;
         persisted: boolean;
     };
-    /**
-     * Personal-token path only. The browser round trip still mints an agent key —
-     * it is what fetches the convention template — and this records whether that
-     * key was handed back before init exited.
-     */
-    agentKeyRevoked?: boolean;
     warning?: string;
+    readiness: InitReadinessStep[];
+    /** Per-adapter detail behind the `local-adapters` readiness step. Additive. */
+    localAdapters: InitAdapterOutcome[];
 };
-export type WorktreeEntryPointState = ConventionEntryPointState;
-export type WorktreeEntryPointEntry = {
-    relativePath: string;
-    state: WorktreeEntryPointState;
-};
-export type WorktreeInitResult = {
+export type ConfiguredProjectInitResult = {
     success: true;
-    mode: 'worktree';
-    worktreePath: string;
-    sourcePath: string;
-    targetPath: string;
-    materialization: 'symlink' | 'copy' | 'relinked' | 'existing' | 'blocked';
-    entryPoints: WorktreeEntryPointEntry[];
-    issues: ConventionIssue[];
-    warning?: string;
+    mode: 'configured-project';
+    configPath: string;
+    conventionPath: string;
+    teamId: string;
+    projectId: string;
+    authMode: AuthMode;
+    credentialSource: 'explicit-api-key' | 'personal-token' | 'config-api-key';
+    conventionsUpdated: boolean;
+    conventionStatus?: ConventionStatusResult;
+    conventionError?: string;
+    doctor: DoctorResult;
+    readiness: InitReadinessStep[];
+    /** Entry points this run wrote or left alone. Additive; the fast path repairs them too. */
+    agentFiles: AgentFileEntry[];
+    /** Per-adapter detail behind the `local-adapters` readiness step. Additive. */
+    localAdapters: InitAdapterOutcome[];
+    postCheckoutHook?: EnsurePostCheckoutHookResult;
+};
+type InitResult = OAuthInitResult | WorktreeInitResult | ConfiguredProjectInitResult;
+export type InitExecutionKind = 'linked-worktree' | 'configured-project' | 'new-project';
+export type InitExecutionContext = {
+    kind: InitExecutionKind;
+    configPath: string | null;
+    config: Partial<Config> | null;
 };
-type InitResult = OAuthInitResult | WorktreeInitResult;
 export declare function detectOsType(): 'MACOS' | 'LINUX' | 'WINDOWS' | undefined;
-export declare function buildAuthorizeUrl(port: number, projectName: string, authPathEnc?: string, osType?: string, state?: string, machineId?: string): string;
-export declare function bootstrapLinkedWorktree(cwd: string): WorktreeInitResult | null;
+export type AuthorizeUrlInput = {
+    port: number;
+    projectName: string;
+    authPathEnc?: string;
+    osType?: string;
+    state?: string;
+    machineId?: string;
+    /**
+     * Present only on the unified setup path. It is what asks the web page to
+     * finish selection *and* the personal-token consent on one screen; a web build
+     * that does not know `flow=setup` simply ignores both parameters, which is why
+     * the `--auth api-key` path must keep omitting them.
+     */
+    codeChallenge?: string;
+};
+export declare function buildAuthorizeUrl(input: AuthorizeUrlInput): string;
+/**
+ * Classify init before it opens a browser or materializes any local adapters.
+ *
+ * This resolver is intentionally read-only: the linked-worktree branch calls
+ * `bootstrapLinkedWorktree` and the configured-project branch resolves its
+ * credential only after classification, so a classification never touches a
+ * keychain, a token, or the filesystem.
+ *
+ * `userHomeDir` is injectable for the same reason as in
+ * `getConfigurationNotFoundMessage`: `os.homedir()` does not follow a test's
+ * `process.env.HOME`, so the global-config rule would be untestable otherwise.
+ */
+export declare function detectInitExecutionContext(cwd: string, explicitAuthMode?: AuthMode, userHomeDir?: string): InitExecutionContext;
 export declare function executeInitCommand(options?: InitOptions): Promise<InitResult>;
-export {};
 //# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,QAAQ,EAAU,MAAM,mBAAmB,CAAC;AAK1D,OAAO,EAQL,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AAyBpC,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;CAC7B,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,8FAA8F;IAC9F,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG,yBAAyB,CAAC;AAEhE,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,uBAAuB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1E,WAAW,EAAE,uBAAuB,EAAE,CAAC;IACvC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,UAAU,GAAG,eAAe,GAAG,kBAAkB,CAAC;AAoCvD,wBAAgB,YAAY,IAAI,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAcxE;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,GACjB,MAAM,CAsBR;AA4eD,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CA6F9E;AAED,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAEnF"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AA+BA,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAW1D,OAAO,EAAwD,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAClH,OAAO,EAGL,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAkB9G,KAAK,WAAW,GAAG;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mFAAmF;IACnF,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,6EAA6E;IAC7E,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,GAAG,YAAY,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEzG,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,oBAAoB,GAAG,eAAe,GAAG,oBAAoB,CAAC;AAE1G,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,+DAA+D;AAC/D,MAAM,MAAM,2BAA2B,GAAG;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,2BAA2B,EAAE,CAAC;CACzC,CAAC;AAEF,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;IAChD,QAAQ,EAAE,QAAQ,CAAC;IACnB,8FAA8F;IAC9F,aAAa,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,+EAA+E;IAC/E,aAAa,EAAE,kBAAkB,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,oBAAoB,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,gBAAgB,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;IAC3E,kBAAkB,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,2FAA2F;IAC3F,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,+EAA+E;IAC/E,aAAa,EAAE,kBAAkB,EAAE,CAAC;IACpC,gBAAgB,CAAC,EAAE,4BAA4B,CAAC;CACjD,CAAC;AAEF,KAAK,UAAU,GAAG,eAAe,GAAG,kBAAkB,GAAG,2BAA2B,CAAC;AAErF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,oBAAoB,GAAG,aAAa,CAAC;AAEzF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAChC,CAAC;AAoCF,wBAAgB,YAAY,IAAI,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAcxE;AAED,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CA0BlE;AAySD;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,QAAQ,EAC3B,WAAW,GAAE,MAAkB,GAC9B,oBAAoB,CAuBtB;AAMD,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAEnF"}